基于 EOS/INode.js 的 DApp 工 程 项 目 实战 - 
-- 去 中 心 化 交易 所 


来 源 : https:/www.chaindesk.cn/witbook/38 


本 项 目 是 使 用 EOS、SmartContract、Node.js、React 等 技术 
架构 ， 采用 链 上 搓 合 与 资产 清算 的 方案 实现 的 去 中 心 化 交易 
所 。 本 系统 核心 业务 逻辑 主要 是 通过 智能 合约 进行 实现 的 ， 

其 中 包括 捞 合 逻辑 的 处 理 、 关 键 数据 的 定义 、 买 卖 单 的 创建 以 
及 订单 注 的 维护 ;而 后 端 服 务 主要 是 以 node.js 技 术 进 行 功能 
实现 ， 一 方面 用 于 与 区 块 链 的 接口 交互 ， 比 如 : 查询 合约 内 数 
据 以 及 链 上 区 块 数据 ; 另 一 方面 主要 用 于 对 外 提供 http 及 
socket 接 口服 务 ， 通 过 整合 业务 数据 及 合约 数据 ， 以 供 前 端 页 
面 的 数据 展示 ; 除 此 之 外 ， 后 端 还 有 配套 的 调度 服务 ， 实 时 同 
步 链 上 数据 ， 并 生成 不 同 维度 的 报表 数据 。 


第 1 章 差异 化 交易 所 的 诞生 


众所周知 ， 在 传统 中 心 化 交易 所 的 选择 上 ， 用 户 往往 最 担心 的 
束 是 质 金 安全 问题 ， 原 本 想 通过 投资 赚钱 却 意外 惨遭 损失 的 情 
况 旦 谁 都 不 想 遇 到 的 ， 所 以 会 优先 选用 那些 信用 度 较 高 且 由 知 
名 机 构 背 书 的 交易 所 。 


但 在 区 块 链 行业 发 展 初 期 ， 很 多 兴起 的 TOKEN 中 心 化 交易 所 
都 是 由 一 些 初 创 型 或 者 稍 有 和 名气 但 不 足以 完全 信任 的 公司 所 运 
草 ， 所 以 提高 了 用 户 心 理 上 的 资金 风险 指数 。 而 且 通过 过 往 
发 生 的 各 种 交易 所 事件 ， 也 佐证 了 交易 所 资金 私 目 挪用 、 了 暗箱 
操作 、 墨 客 攻击 等 事件 发 生 的 可 能 性 ; 除 此 之 外 ， 还 要 面临 公 
司 内 部 运 宇 风险、 交易 不 透明 等 问题 。 


与 此 同时 ， 随 痢 区 块 链 的 进一步 发 展 ， 出 现 了 不 同 解 决 方案 

的 去 中 化 交易 所 ， 用 来 解决 中 心 化 所 带 来 的 各 种 风险 问题 。 

其 核心 优势 在 于 规避 集中 式 资 产 管 理 ， 用 户 对 目 己 的 资产 拥 

有 绝对 的 所 有 权 与 控制 权 ， 因 此 质 产 被 盗 的 可 能 性 极 低 ， 很 大 
程度 上 降低 了 用 户 对 交易 所 的 信任 成 本 。 但 由 于 资产 的 交易 操 
作 走 由 区 块 链 来 驱动 的 ， 所 以 也 会 受到 区 块 确认 速度 的 限制 ， 
近 而 影响 用 户 体 验 。 


目前 的 商业 典型 案例 有 :，EtherDela、0x、Kyber、 
Loopring、bitshares 等 。 


第 2 章 项 目 介绍 


本 项 目 是 使 用 EOS、SmartContract、Node.js、React 等 技术 
架构 ， 采用 链 上 搓 合 与 资产 清算 的 方案 实现 的 去 中 心 化 交易 
所 -” 


在 交易 所 中 ， 用 户 可 以 直接 使 用 目 己 的 钱包 进行 帐号 登录 ; 
然后 使 用 目 己 的 用 户 权限 直接 创建 天 / 卖 订 单 ， 而 无 需 进行 币 
种 充值 ， 当 系统 发 现 订 单薄 中 存在 符合 搓 合 价格 要 求 的 订单 
后 ， 则 由 系统 直接 进行 搁 合 ， 并 将 搁 合 日 志 记 录 至 区 块 链 上 ; 
最 后 ， 由 系统 将 搁 合 成 功 的 部 分 或 完全 成 区 的 TOKEN 和 转帐 到 
对 方 帐号 地 址 。 


尺 外 ， 当 系统 调度 发 现 链 上 存在 成 区 日 志 时 ， 会 目 动 将 成 区 记 
永 同 步 至 后 端 服务 数据 库 ， 并 同步 更 新 K 线 独 报 表 数 据 以 及 实 
时 更 新 币 价 信息 ; 最 后 ， 根 据 变动 的 信息 数据 ， 通 过 socket 
服务 将 请 妃 推 送 到 前 端 展示 页 。 


本 系统 核心 业务 逻辑 主要 二 通过 智能 合约 进行 实现 的 ， 其 中 
包括 搁 合 逻辑 的 处 理 、 关 键 数 据 的 定义 、 严 卖 单 的 创建 以 及 订 
单薄 的 维护 ， 而 后 端 服务 主要 是 以 node.js 扩 术 进 行 功 能 实 
现 ， 一 方面 用 于 与 区 块 链 的 接口 交互 ， 比 如 : 查询 合约 内 数据 
以 及 链 上 区 块 数据 ; 另 一 方面 主要 用 于 对 外 所 供 http 及 socket 
接口 服务 ， 通 过 整合 业务 数据 及 合约 数据 ， 以 供 前端 页 面 的 数 
据 展 示 ; 除 此 之 外 ， 后 端 还 有 配套 的 调度 服务 ， 实 时 同步 链 上 
数据 ， 并 生成 不 同 维度 的 报表 数据 。 


第 3 章 系统 架构 及 功能 设计 


从 拉 术 角度 讲 ， 整个 项 目的 技术 如 构 网 如 下 


从 功能 结构 上 ， 主 要 划分 为 六 大 模块 : 
。 基础 数据 管理 ; 

。 订 香 管 理 

。 皖 合 管理 


。 系统 管理 
。 报 和 均 管 理 
。 调度 管理 


基础 数据 管理 ， 主 要 用 于 维护 币 种 及 交易 对 数据 。 币 种 管理 
主要 用 于 定义 当前 交易 所 所 文 持 的 币 种 ， 比如 币 种 名 称 ， 合 
约 名 称 及 资金 精度 等 ， 交 易 对 管理 主要 用 于 定义 基准 代 币 可 部 
换 的 币 种 、 交 易 对 最 小 订单 量 以 及 手续 费 等 信息 ; 


订单 管理 ， 主要 用 于 维护 用 户 订单 数据 以 及 交易 所 订单 落 数 
据 。 用 户 订单 功能 主要 用 于 记录 用 户 实时 创建 的 买 / 卖 单 交易 
数据 ， 其 中 包括 交易 对 、 购 买 价格 、 订 单 量 、 订 单 状态 等 

据 信 息 ， 而 订单 薄 功 能 主要 用 于 对 交易 所 所 有 的 订单 按 卖 买 类 
型 进行 分 队列 排序 ， 从 而 方便 展示 当前 交易 对 的 交易 深度 以 及 
供 接合 功能 处 理 

接合 管理 ， 主要 用 于 实时 将 订单 薄 中 符 中 接合 条 件 的 订单 进 
行 数据 处 理 ， 并 同时 更 新 用 户 订单 数据 以 及 资金 清算 等 业务 
系统 管理 ， 主要 用 于 维护 交易 所 配置 数据 以 及 运营 状态 。 比 
如 ， 是 否 锁定 或 开启 交易 所 ; 

调度 管理 ， 主要 用 于 实时 监控 链 上 搓 合 成 交 记 录 ， 并 实时 同 
步 订单 数据 至 数据 库 ， 供 前 端 K 线 图 的 数据 展示 ; 

报表 管理 ， 主要 用 于 通过 交易 市 场 的 交易 情况 实时 展示 K 线 图 
报表 数据 以 及 实时 更 新 所 有 交易 对 币 价 信息 ， 比如 : 24 小 时 
成 交 量 ， 当前 币 种 价格 、 涨 跌幅 等 信息 。 


小 结 

通过 本 章 世 的 学 习 ， 我 们 了 解 了 整个 交易 所 项 目的 整体 技术 架 
构 ， 包 括 底层 基础 设施 、 服 务 组 件 、 业 务 模块 、 系 统 划 分 以 及 
与 前 病 交 互 展 示 等 ， 并 详细 介绍 了 整个 项 目的 业务 模块 功能 。 


在 教程 中 如 出 现 不 易 理 解 或 存在 钴 误 的 问题 ， 欢 迎 加 我 微 
信 指 正 ! Name: zhangliang | WeChat: rushking2009 | Mail 
zhanglliang@Qcldy.org 


第 4 章 业务 流程 图 
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第 5 章 工程 环境 搭建 


5.1 章节 简 述 
本 章节 将 会 分 为 两 个 小 章 忆 进行 分 别 讲解 : 


。 前 期 环境 配置 
。|1DE 配 置 及 工程 目录 搭建 


本 期 环境 配置 

该 小 节 主要 向 大 家 介绍 在 实际 开发 过 程 中 所 依赖 的 一 些 系统 服 
务 组 件 以 及 在 团队 协作 办 公 中 所 不 可 或 缺 的 文档 管理 、 代 码 管 
理 等 工具 。 


IDE 配 置 及 工程 目录 搭建 

本 教程 我 们 采用 的 是 vscode 工 具 进 行 开发 的 ， 而 本 项 目 因 为 
会 涉及 多 种 语言 的 开发 ， 所 以 我 们 需要 通过 vscode 安 闭 一 些 
揪 件 以 方便 提高 我 们 的 开发 效率 ; 另外 ， 还 会 讲述 如 何在 本 
地 快速 搭建 一 个 标准 化 EOS 工 程 项 目 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


5.2 前 期 环境 配置 


本 章节 主要 介绍 在 项 目 开 发 之 前 需要 进行 配置 的 开发 环境 ， 其 
中 涉及 EOS 私 链 搭建 所 需要 用 到 的 Docker、 对 项 目 代码 进行 
管理 的 版 本 管理 工具 Git 等 。 


1. Docker 容 器 


考虑 到 在 实际 的 项 目 开 发 环节 中 ， 为 了 便于 调试 代码 ， 所 以 需 
要 在 本 地 进行 EOS 私 链 环 境 搭 建 ， 而 本 吴 如 采 通 过 编译 安 疼 的 
方式 ， 那 么 会 伦 费 可 能 一 天 的 时 间 用 来 单单 安 闻 环 境 ， 为 了 解 
决 这 个 问题 ， 我 们 采用 Docker 容 器 技术 可 以 快速 方便 局 动 的 
一 个 干净 的 私 链 环境 ， 可 以 供 我 们 随时 删除 重建 一 个 开发 环 


境 。 


。 Mac 

https://docs.dockercom/docker-for-mac/install/ 
e。 [LinUX 
How To Install and Use Docker on Ubuntu 18.04 
CentOsS 
https://docs.dockercory/install/linux/docker-ce/centos/ 
Window 
Install Docker Desktop for Windows 


详细 说 明 。 
2. Node.js 


因为 在 EOS 公 链 开发 生态 中 ， 提 供 了 由 js 实现 的 eosjs sdk， 考 
虑 到 方便 性 ， 所 以 我 们 将 采用 Node 技 术 来 进行 与 公 链 的 交 
互 ， 以 及 对 外 发 布 数据 接口 ， 供 前 端 页 面 进行 数据 展示 。 


下 图 展示 了 操作 系统 用 到 的 Node 安 装 包 ， 可 通过 下 面 提供 的 
链接 访问 下 载 。 


LTS Current 


Recommended For Most Users Latest Features 


国明 


| 

Windows Installer macoOs Installer Source Code 
Windows Installer (.msi) 32-bit 64-bit 
Windows Binary (.zip) 32-bit 64-bit 
macoOs Installer (.pkg) 64-bit 
macOs Binary (-tar.gz) 64-bit 
Linux Binaries (x64) 64-bit 
Linux Binaries (ARM) ARMV6 ARMv7 ARMv8 
Source Code node-v10.15.1-tar.gz 
Additional Platforms 
SmartOs Binaries 64-bit 
Dockerlmage Official Node.js Dockerlmage 
Linux on Power Systems 64-bit 
Linux on System z 64-bit 
AIX on Power Systems 64-bit 


https:/nodejs.org/en/download/ 


除 上 述 安 闭 方 式 外 ， 也 可 使 用 第 三 方 包 管 理工 具 进行 下 载 ; 
NVM (Node Version Manager ) ， 是 Node 版 本 的 包 管 理工 
具 。 可 以 使 用 此 工具 方便 的 进行 Node 版 本 安装 与 切换 。 另 
外 ，NVM 工 具 的 安装 极其 方便 ， 仅 需 两 步 。 


1. 安装 软件 
使 用 cur| 


curl -0- https:VZ/Lraw.githubusercontent ,com/creat1io 


使 用 wget 


wget -qdq0- https://raw,.githubusercontent .com/creat1i 


注 : 以 上 命令 安装 成 功 后 ， 即 可 以 ~/.nvm 目 录 下 找到 其 执行 脚 
本 
2. 修改 环境 变量 为 了 使 nvm 命 令 全 局 环境 下 生效 ， 需 要 进行 


环境 变量 设置 。 


export NVM_DIR="${XDG_CONFIG_HOMEXZ : -$HOME/ .+nvmy” 
[ -S "$NVM_DIRXZnvm,.Sh"” ] && \，"$NVM_DIRVZnvm.Sh”"” # 


将 以 上 代码 复制 到 环境 变量 配置 文件 ( 

= basn proflle ， =/ zsnrcl 

~/,profile`，or “`-~/,.bashrc， 可 根据 自己 的 实现 效果 选 
择 任 一 即 可 )。 最 后 ， 通 过 执行 source ~/< 配 置 文件 > 使 配置 文 
件 生效 即 可 。 


3. 1DE 


关于 IDE 的 选择 ， 推 荐 使 用 VSCode。 通 过 一 段 时 间 自 己 的 使 
用 ， 发 现 经 体 量 小 、 拥 有 丰富 的 组 件 库 ， 在 一 个 项 目 里 就 可 以 
覆盖 多 模块 项 目的 开发 。 比 如 我 们 即将 要 开发 的 交易 所 项 目 ， 
就 牵扯 到 C++、Node.js、react 等 多 种 代码 实现 ， 而 vscode 完 
全 可 以 胜任 这 种 复合 工程 。 

。 当然， 大 家 也 可 以 使 用 自己 顺手 的 IDE 进 
行 开发 。 


官网 链接 : https:Wcode.visualstudio.comy/ 


4. Gilt 


在 项 目 开发 环境 ， 往 往 都 是 需要 多 人 共同 协作 来 完成 一 个 项 
目 。 那 么 我 们 束 需 要 统一 的 信息 版 本 管理 工具 ， 来 帮助 我 们 达 
到 高 效率 工作 。 尤 其 是 对 于 程序 员 来 ， 可 能 会 重复 的 修改 需 
求 ， 殉 可 能 需要 我 们 随时 从 过 去 的 版 本 找到 一 段 代码 ， 或 者 是 
在 多 人 共同 编辑 而 导致 的 冲突 问题 ， 都 可 以 通过 git 得 以 解决 。 


httpSs:/gitcscm.com/downloads 


通过 本 人 小玉， 我 们 基本 吕 完 成 了 整个 开发 环境 日 惠 所 用 到 的 开 
发 工具 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail 
zhangliang@cldy.org 


5.3 快速 搭建 基于 Github 的 EOS 模 板 工 程 


本 章节 主要 介绍 如 何 快速 构建 一 个 基于 EOS 的 项 目 工 程 结构 ， 
以 及 如 何 通过 本 工程 快速 局 动 一 个 EOS 私 链 环境 、 如 何 编译 及 
发 布 一 个 智能 合约 。 我 将 会 通过 演示 一 个 简单 示例 的 开发 ， 
来 市 领 大 家 快速 了 解 此 工程 结构 及 工程 命令 的 使 用 。 


对 于 各 悉 区 块 链 DApp 开 发 的 朋友 可 能 都 比较 清 条 ， 所 有 链 
DApp 的 开发 流程 基本 就 是 : 链 环境 搭建 、 合 约 编码 、 合 约 编 
译 、 合 约 发 布 四 个 步骤 。 


比如 在 以 太 坊 公 链 生态 体系 中 ， 提 供 了 truffle + Ganache 的 组 
合 开 发 模式 ， 通 过 这 套 框架 模式 可 以 快速 的 局 动 链 环境 、 对 合 
约 编译 与 升级 ; 相反， 在 EOS 生 态 体系 中 ， 开 发 基础 设施 并 不 
算 健 全 ， 只 能 是 程序 员 在 项 目 开发 过 程 不 断 总 结 与 优化 自己 
的 开发 流程 ， 将 一 些 重复 性 且 较 为 耗 时 的 操作 进行 脚本 化 从 而 
达到 一 些 效 率 上 的 提升 。 

毫 无 例外 ， 我 也 是 在 经 历 几 个 EOS DApp 项 目的 开发 过 程 ， 不 
断 改 进 一 些 中 间 开 发 环节 的 流 节 ， 比 如 : 链 环 境 由 最 初 的 本 地 
编译 改 为 docker 部 署 ， 从 而 整合 出 的 一 套 项 目 工 程 模板 


eos_bollerplate 。 


eos_boilerplate 是 基于 EOS 公 链 设计 的 一 套 可 快速 启动 私 链 
环境 、 快 速 对 智能 合约 进行 编译 、 调 试 、 发 布 的 标准 化 工程 模 
板 。 

该 工程 模板 主要 用 于 : 帮助 大 家 快速 搭建 项 目 工程 ， 减 少 在 环 
境 搭建 、 集 成 前 端 组 件 环节 的 大 量 时 间 痕 费 ， 让 大 家 集中 更 多 
的 精力 放 在 具体 业务 逻辑 实现 上 。 


该 套 模 板 主 要 使 用 Node.js、Docker、eosjs、Shel1、jest 
四 种 技术 进行 项 目 开 发 流程 倘 化 。 该 工程 文 持 ; 


。 一 键 式 局 动 、 俘 止 、 重 局 、 重 置 私 链 环境 
。 一 键 式 编译 智能 合约 

。 一 键 式 发 布 智能 合约 

。 多 合约 文件 时 ， 可 指定 合约 进行 编译 与 发 布 
。 一 键 式 单元 测试 


第 一 步 、 从 GitHub 克 隆 或 Fork 模 板 工 程 


在 工程 构建 这 块 ， 提 供 了 两 种 方式 进行 项 目 初 始 化 ， 任 选 其 一 
印 可 。 


方式 一 、 直 接 Fork 模 板 工程 
1. 打开 浏览 器 ， 访 问 工 程 模板 项 目 


ChainDesk/eos_ bollerplate 


2. 点 击 页 面 中 的 Fork 按 钮 。 如 果 你 帐户 里 存在 多 个 组 织 ， 需 
要 选择 要 fork 到 组 织 帐 户 或 个 人 帐户 


以 下 界面 表示 正在 Fork 中 ， 稍 等 几 秒 钟 即 可 结束 。 
3. 点 击 页 面 中 的 setting 按 钮 ， 修 改 目 己 定 义 的 项 目 名 称 


Repository name 
eos_boilerplate 


4. 区 隆 项 目 到 本 地 环境 


一 一 和 
Clone with HTTPS @ Use SSH 
| Use Git or checkout with SVN using the web URL. 


打开 本 地 命令 窗口 , 执行 以 下 克隆 命令 : 


glt clone 
gitQ@dgithub.com:ChainDesk/eos_boilerplate.git \< 项 目 
名 称 > 注意 : 此 处 git 地 址 需 改 为 目 己 工程 的 地 址 


方式 二 、 克 隆 


1. 在 Github 官 网 ， 先 注册 好 上 自己 的 github 帐 户 

2. 创建 自己 的 项 目 仓库 

3. 打开 提供 的 工程 模板 项 目 链接 eos_boilerplate 

4. 复制 项 目 git 地 址 ， 打 开本 地 命令 窗口 ， 执 行 克 隆 操 作 


> gilit clone gitQgithub .com:ChainDesk/eos boiler 


5. 将 克隆 项 目的 远程 地 址 修改 为 自己 的 项 目 仓库 


执行 以 下 命令 ， 进 行 git 仓 库 地 址 修改 
> git config remote,origin,url < 自己 项 目 仓 库 地 址 > 


# 查看 是 否 修改 成 功 
> git config --] 1Sst 


当 克 隆 成 功 完成 后 ， 目 孙 结 构 如 下 : 


| 一 README .md 。 // 项 目 文档 介绍 
[7 


7C~m 由 亚 /Vermnqems qie 丙 于 


As /7 VDuUUwU -US 有 LU _ 目 . 

ts 

| |) 上 上 compile.sh //IL， 编 译 合约 

| 1) 上 上 deploy.sh //2， 发 布 合约 

| | 上 上 六 dockerservice,.sh//3， 容 器 管理 

| | 一 test,sh /V/4， 测试 单个 js 文件 

| ”|! 一 tasks， 人 // 局 动 、 暂 停 私 链 、 编 译 合 约 、 发 布 合 给 
一 contracts 智能 合约 目 永 列表 

he11o 人 用 户 可 目 定 义 合 约 目 孙 

人 neoORcphp 

[一 eosio.token 

| 一 eosio.token,cpp 

eosio.token,hpp 

| 一 docke /VDocker 配 置 目录 

让 二 2 

| | 上 continue_ blockchain,.sh // 非 首次 启动 链 环境 
| | [上 六 create _ accounts,sh // 创 建 E0S 测 试 帐 ) 
人 可 sa 

| |) 上 上 deploy contract.sh // 发 布 合约 脚本 
| 一 eosio.cdt-1.3.2.Xx86_64.deb 

| |) 一 init_ blockchain,sh // 表 次 初始 化 区 块 
| [一 start_eosio_docker .sh // 启 动 私 链 脚本 
上 一 migrations 

| [一 5 deploy_contracts,js // 通 过 脚本 发 布 合 : 
| 一 package,.json 

[一 test // 测 弃 用 例 目 永 ， 


| 一 constants ,js 
dos Secis 
-一 utils.js 


8 directorlies，20 fliles 


上 述 目 了 永 结 构 及 注释 ， 便 是 对 整个 工程 的 详细 描述 。 
第 二 步 、 配 置 vscode 快 捷 键 


首先 ， 通 过 菜单 《code->Preferences->Keyboard 
Shortcuts) 或 快捷 键 〈 踢 K 器 S) 进入 快捷 链 配置 界面 


重耳 本 File Edit selection view Go Debug Terminal Window 上 


Keyboard Shortcuts | 纯 K 3 殷 S |] 


站 


》 


然后 ， 点 击 界面 中 的 keybindings.json 进 入 快捷 键 自 定义 文 
件 


加 Keyboard Shortcuts X 


Typeto search in keybindings 


ced custo “和 请 直 2dj 基 keybindings.json 
Command Keybinding Source 
Add Cursor Above 下 其 下 个 Default 
Add Cursor Below 了 Default 
Add Cursorsto Line Ends Default 
Add Cursorsto Line Ends 站 Default editorTextFocus 
Add File Default 一 
Add Fileto .gitignore User 一 
Add Line Comment Default editorTextFocus && 1!editorReadonlLy 
Add Selection To Next Find Match Default editorFocus 
Back 二 Default tinQuickopen 
Beautify file User 
Beautify selection User 
Build Default 


Build atarget Default 


在 keybindings,json 中 ， 添 加 快捷 键 与 执行 脚本 间 的 映射 天 
系 


{ ，// 重 局 原 有 私 链 环境 
"Key"”: "ctr]+e"， 
"Command”": "workbench.action.tasks,.runTask'"， 
"args"”: "RestartChalin” 
| 
// 删 除 原 有 私 链 环 境 数 据 ， 重 新 启动 新 私 链 
"Key"”: "ctrJ+ShIft+e"”， 
"Command”": "workbench.action.tasks,.runTask'"， 
"argSs"”: "NewStartChalin” 
本 
// 停 止 私 链 环 境 
"Key"”: "ctrJ+SshiIft+d"”， 
"Command”: "workbench.action.tasks,.runTask'"， 
"argSs"”: "StopChainy" 


// 编 译 + 发 布 合约 
As He EL 
"Command": "workbench.action,.tasks.runTask'"， 
"argds": "DepJoyContract” 
和 
// 编 译 合约 
Ke ae tialesnas 人 EEC 
"Command": "workbench.action,tasks.runTask"， 
"argds": ”CompIJecontract " 


]}， 
你 可 以 根据 目 己 的 实际 情况 目 由 设 定 不 同 任务 对 应 的 快捷 键 。 
补充 一 点 ， 即 使 你 不 配置 快捷 键 也 是 可 以 执行 对 应 脚本 的 。 那 


瓯 是 通过 荣 单 View->Command Palette 技 
行 >Tasks:Run Task, 然后 选择 要 执行 的 脚本 任务 名 称 即 可 。 
脚本 任务 的 名 称 可 从 项 目 工程 中 .vscodejtask.json 中 找到 。 


惫 code File Edit Selection View Go Debug Terminal Window Help 


EXPLORER > 


WORKMETA (W( Tasks: Run Task 
4 全 sos dapl Icons: Activate VSCode Icons 
1 CMake: Run tests 
4 昱 .vsScod CMake: Executethe currenttarget without a debugger 
》 Scrif CMake: Select a Kit 
Settl CMake: Install 
task CMake: Build 
CMake: Quick start 


》 eosio.token 


4 园 hello 


hello.cpp 


轧 docker 


矿 ”code File Edit Selection View Go Debug _ Terminal Window Help 介 是 口 


器 EXPLORER lselectthetaskto run 
4 WORKMETA (W( DeployContract eos_dapp_sample4exchange recently usedtasks 向 
品 4 名 sos dapl CompileContract eos_dapp_sample4exchangk 
1 NewStartChain eos : 


4 克 .vscod StopChain eos_dapp_sample4exchange 
匆 scrirf RestartChain eos_dapp_sample4exchange 


第 三 步 、 局 动 私 通 环境 


通过 快捷 键 ctrL1+shift+e 或 运行 >Tasks:Run Task 方 式 直 接 
运行 NewStartCchain 任 务 。 控制 台 会 打印 如 下 信息 : 


大 国 遇 EU 天、 本 人 人 
项 因 于 苔 三 册 网 本 全国 攻 丽人 全 昨 二 


RPR 本 | 辣 时 RE N\ 


docker 's name : eos_dapp_sample4exchange 
docker 'Ss Status : restart 


== Stop docker container and rm the data dir， 

Error response from daemon: No Such container: eos 
Error: No Such contaliner: eos_dapp_sampJe4exchange 
=== run docker container from the eoslio/eos-dev inm 
b121d77dd864d34ab8dea381fa267fb97c5b423abb953f1675 
=== folLLow eos_dapp_sampJe4exchange Logs === 

=== Setup blockchain accounts and smart contract = 
=== Install EOSI0O.CDT (Contract DeveJlopment ToolLki 


Info 2019-02-28T06:04:07.006 thread-0 producer_p 


如 果 能 够 正常 打印 Produced block 信 息 表 明 私 链 正 常 启动 。 


第 四 步 、 编 写 简 单 示例 合约 


为 了 方便 进行 工程 的 演示 ， 在 项 目 根 目 永 contracts 文 件 夹 里 我 
们 事先 准备 了 一 个 简单 的 示例 合约 : 


/人 fillename: heJllo.cpp ”/ 
#InclLude <eos1lIolLip/veosio.hpp> 
#InclLude <eos1lIolLipZprint.hpp> 


USlIng namespace eoSlio 


Class he]llo : pubJlic contract 1{ 
pupbJlic : 
USling contract: :contract ; 


[[eoslio::action|]j 
vold hzI( name User ) 革 
print( "Hello，"”，Userr ) ; 
了 


EOSIO_DISPATCH( hel1o， (hiy) ) 
第 五 步 、 编 译 合约 


选中 要 编译 的 合约 文件 ， 使 用 快捷 键 ctrl+shift+c， 会 发 现 
控制 台 打 印 : 


情况 一 : 如 果 显 示 以 下 信息 ， 则 代表 合约 编译 正常 


| 

| 

有 攻 是 放 用 轴 策 赐 员 局 必 避 胃 辣 | 克 本 天 |E 三 | 站 司 | 站 | 

| 
屋 | 

contract 's name : he Jo 


Terminal will be reused by tasks，press any Key to 


情况 二 :如果 显 示 以 下 信息 ， 则 代表 合约 编译 失败 


| 本 | 二 二 二 汪 二 
1 人 证 册 而 证 让 册 
随 辐 放生 辣 局 必 是 二 帮 六 司 遇 硬 必 辣 省 玫 | 屋 和 员 加 
| 二 全 二 和 攻 必 隐 放 从 玫 二 放生 


1 一 1 
contract 's name : he]ljlo 
/opt/eosio/Xbinvcontracts/vhello/vhello.cpp:12:33: er 
prlInt( “Hello， ，User ) 
八 
1 error generated， 
The terminal process terminated with exilit code: 25 


第 六 步 、 发 布 合约 

在 保证 合约 编译 正常 之 后 ， 我 们 可 以 直接 发 布 合约 至 本 地 私 链 
上 。 选 中 要 发 布 的 条 能 合约 ， 执行 ctrLI+r 快 捷 键 执 

行 Deploycontract 任务 ， 如 下 显示 如 下 信息 则 表明 发 布 合 
约 成 功 。 


| 

本 | 国 国 ER 轴 4 

本 国 辕 | 后世 呈 国生 中 量 辐 痢 网 下属 要 昌国 山 必 | 

[AN | 本 关 | 全 | 中国 
属 | | 攻 二 二 人 

Contract 's name : he lo 


UnJlocked: hackdappexcnh 

Reading WASM from /Vopt/eosioXbiIn/ycompIJled_contract 
PublLishing contract ,,， 

executed transaction: 2014ecfob3d26eb76d7dafaf41d6 
warn 2019-02-28T06:31:48.857 thread-0 main.cpp:4 
共 eoSlo <= eoslo: :setcode 全 
共 eoSlo <= eoSslio: :Setabi 人 


可 能 有 朋友 会 问 ， 我 发 布 的 是 hello 合 约 ， 怎 么 日 志 中 却 显示 的 
其 它 用 户 呢 ? 其 实 ， 合 约 文 件 的 定义 与 具体 的 合约 名 是 没有 

人 

正常 情况 下 , 使 用 eos 命 令 发 布 全 约 的 完整 命令 十 : 


> Cleos set_ contract < 合约 名 > < 合约 文件 目 孙 > -p 合约 名 


e.g. 


> Cleos Set contract hackdappexch comp1Iled_contrac 


第 七 步 、 合 约 调用 
在 合约 发 布 成 功 后 ， 我 们 尝试 调用 合约 方法 


# 工 ， 解 锁 钱 包 (hackdappexch 帐 户 已 经 在 初始 化 链 环境 时 生成 ) 
> Cleos wallet unlock -n hackdappexch --password $ 


# 2， 方 法 调用 

> Cleos push action hackdappexch hi [ 11Ly"] -p ha 
executed transact1lion: 255c7982471641ae1674a3b44f06 
#_ hackdappexch <= hackdappexch: :hi 全 
>> Hel1o，]111y 


到 此 ， 我 们 完整 演示 了 如 何 通 过 本 工程 进行 司 动 链 环境 、 合 约 
开发 、 编 译 及 发 布 入 能 合约 的 一 系列 完整 流程 。 


通过 本 小 下 ， 我 们 学 会 了 在 本 地 快速 搭建 一 个 EOS 工 程 项 目 ， 
通过 脚本 命令 快速 局 动 一 个 本 地 的 私 链 环境 以 及 通过 编译 和 发 
布 脚本 快速 部 车 一 个 智能 合约 到 私 链 上 。 


在 教程 中 如 出 现 销 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail: 
zhangliangQ@Qcldy.org 


HackiHook 和 
急 人 所 才 四 砚 加 速 鉴 一 去 中 心 交易 所 


changelog 
2019-03-04 zhangliang 


。 亡 次 发 入 
2019-03-16 zhangliang 
。 提供 两 种 工程 克隆 方式 


第 6 章 知 能 合约 开发 


6.1 章节 人 简 述 

<< 后 端 服务 开发 >> 本 章 世 将 分 为 两 部 分 进行 讲解 ， 第 一 部 分 
主要 介绍 基于 Node 如 何 整 合 相 关 组 件 ， 其 中 包括 调度 、 多 配 
置 、 日 志 、Ssocket、EOSSDK 等 ;第 二 部 分 主要 介绍 如 何 对 外 
提供 业务 服务 接口 以 及 区 块 业 务 数据 同步 等 。 比 如 : 对 外 提供 
K 线 图 实时 报表 数据 、 交 易 所 所 有 交易 对 实时 价格 等 。 


第 一 部 分 、 组 件 集成 


。 基 础 框架 整合 
。 整 合 EOSSDK 


第 二 部 分 、 业 务实 现 
。 搁 合 调度 功能 设计 与 实现 
。 区 块 同 步 功 能 设计 与 实现 
。K 线 图 报表 功能 设计 实现 
。 实时 币 价 功能 设计 与 实现 


通过 本 章节 的 学 习 、 思 考 与 实践 ， 大 家 可 以 从 整个 开发 周期 ， 
学 会 如 何 能 根据 实际 业务 需求 选择 合适 的 技术 组 件 ， 学 会 如 
何 与 EOS 链 环境 间 的 RPC 交 互 以 及 交易 等 名 等 ， 最 后 根据 交 
易 所 功能 需求 文档 完成 对 外 服务 接口 的 实现 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail: 
zhangliang@Qcldy.org 


注 : 有 想 了 解 愿 码 全 思维 IT 工 
程 师 加 速 器 的 朋友 ， 可 以 扫 码 加 群 咨询 。 


changelog 
2019-03-11 zhangliang(mallto:zhangllang@cldy.org) 


。 亡 次 发 祝 


6.2 TOKEN 管 理 -- 模 块 设计 


TOKEN 管 理 


本 小 下 主要 分 析 与 介绍 交易 所 合约 中 TOKEN 管 理 业务 模块 的 
数据 结构 、 业 务 逻 辑 判断 、 约 束 条 件 、 操 作 权 限 以 及 可 能 存在 
的 淤 在 安全 漏洞 等 问题 


功能 介绍 


TOKEN 管 理 : 主要 用 于 负责 对 交易 所 中 所 文 持 TOKEN 的 基础 
数据 定义 。 比 如 ，EOS、KARMA、DICE 等 基于 EOS 链 发 布 
的 TOKEN。 需 要 说 明 的 是 : 该 交易 所 只 文 持 EOSTOKEN ， 跨 
证 TOKEN 十 不 文 持 的 ， 比 如 ETH 等 。 


比如 : EOS 的 代 币 名 称 为 EOS， 合 约 名称 为 eosio.token。 需 
要 注意 的 是 : 代 币 名 称 相同 ， 并 不 意味 着 是 是 相同 币 种 ;同时 
还 需要 判断 是 否 为 同一 个 合约 地 址 。 和 否则 会 导致 充值 到 交易 所 
中 的 是 假 的 代 币 。 


数据 结构 
字段 数据 类 型 说 明 
可 由 用 户 填写 ， 也 可 由 系统 
主键 ， uint64 1 自动 生成 
token string 代 币 名 称 


名 称 


字段 数据 类 型 次 明 


合约 名 称 ， 从 eoslib 库 进行 类 
型 查询 。 举 例 : "symbol": 


合 经 
名 称 Re De "4.EOS" "contract': 
"eosio.token" 
业务 约束 


。 只 允许 合约 管理 员 进 行 操作 
。 不 允许 存在 重复 的 币 种 名 称 
。 不 允许 存在 重复 的 合约 名 称 
。 删除 token 时 需 确 你 关联 数据 已 经 删除 


权限 有 要求 
。 仅 限 合约 管理 员 操作 
安全 问题 


。 权限 难 证 

。 方法 分 级 授权 
可 以 将 管理 员 根 据 业 务 不 同 进行 细 粒 度 权 限 授权 。 确 保 天 
键 业 务 保留 在 权限 高 的 管理 员 手 中 。 比 如 : 可 以 将 修改 
TOKEN 方 法 的 管理 员 与 管理 资金 的 管理 员 进 行 权 限 切割 ， 
以 达到 资金 的 相对 安全 。 


技术 实现 
由 项 目 成 员 自主 设计 与 实现 。 
涉及 命令 知识 


。 查 看 Docker 服 务 


docker ps 


。j 进 入 Docker 命 令 窗口 


docker exec -1t <contaliner name> /binXbash 
。 解 镜 钱包 
cleos wallet un1lock -n < 钱包 名 称 > --password < 钱 反 


# 例如 : 打开 名 称 为 hackdappexch 的 钱包 
cjJeos wallet unjlock -n hackdappexch --password : 


cleos set contract < 合约 名 > < 合约 目 永 > -p < 合约 和 名 > 人 


。 调用 合约 方法 


cleos push action < 合约 名 > < 合约 方法 > [< 参数 1>，< 参 志 


。 查 询 数 据 表 


cleos get tab1le < 合约 名 > <scope> < 表 定 义 > 
# Scope 值 取决 于 实例 化 索引 时 所 传 入 的 值 ， 一 般 实例 化 索引 时 


通过 本 章节 的 学 习 思 考 与 代码 实现 ， 我 们 完成 了 对 交易 所 
TOKEN 的 添加 、 修 改 、 删 除 三 个 功能 方法 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhanglliang@Qcldy.org 


6.3 TOKEN 管 理 -- 代 码 实现 
交易 所 智能 合约 之 TOKEN 管 理 代 码 实 现 


在 \<\<TOKEN 管 理 >> 章 节 中 ， 我 们 介绍 了 TOKEN 管 理 所 涉 及 
的 数据 模型 、 业 务 逻 辑 、 约 束 条 件 以 及 合约 方法 的 权限 要 求 ， 
那么 本 章节 将 会 根据 这 些 功能 描述 进行 具体 代码 实现 。 
在 所 有 的 功能 实现 中 ， 我 们 将 遵循 数据 结构 定义 、 索 引 老 定 
义 、 接 口 方法 定义 以 及 方法 实现 四 个 步骤 进行 分 步 讲解 实现 : 


第 一 步 、 定 义 TOKEN 数 据 结构 


在 \<\<TOKEN 管 理 >> 数 据 结构 定义 ， 定 义 了 四 个 字段 。 其 中 
使 用 了 一 个 可 能 比较 陌生 的 字段 类 型 即 ; 
eosio::extended_symbol。 该 数据 类 型 其 实 是 由 eoslib 库 所 封 
装 的 一 种 存储 合约 的 类 型 ， 主 要 用 于 记录 TOKEN 名 称 、 精 度 
以 及 TOKEN 所 归属 的 合约 名 称 三 项 信息 。 


其 具体 实现 代码 如 下 所 未: 


struct [Leosio::tabple]j]j] token_struct { 
UInt64 t 1Id， 
String Symbol_name ; 
eoSsSlo::extended symbol ext_symbol; 
Uint64 t precision， 


Ulint64 t get_by_ symbol() const 1{ 
return ext_symbol.get_sympol().raw() ，; 


】} 


Uint64 t get_by_contract() const 1{ 
return ext_symbol.get_contract().vValue 


} 
UiInt64 t primary_key() const { return Id; } 


EOSLIB_SERIALIZE( tokenstruct， (id)(Symbol_nam 
) 


其 中 , symbol_name 字 段 用 于 存储 TOKEN 对 应 的 币 名 称 ; 
ext_symbol 字 段 主 要 用 于 存储 合约 信息 ; precision 主要 用 
于 定义 币 种 的 数据 精度 。 


该 段 代 码 前 半 部 分 ， 定 义 了 业务 所 必需 的 字段 定义 ; 之 后 ， 你 
会 发 现 三 个 方法 get by_symbol、get_ by_contrac、 
primary_key， 这 些 方法 主要 是 为 了 给 索引 吉 提 供 索 引 查 询 使 
用 ; 而 最 后 EOSLIB_SERIALIZE， 主 要 用 于 对 合约 数据 的 序 
列 化 与 反 序 列 化， 方便 对 合约 的 存储 与 读 取 。 


需要 注意 的 是 如 果 想 让 智能 合约 abi 文 件 出 现 此 结构 体 的 数据 
定义 ， 那 吏 需 要 在 表 结 构 中 添加 [[eosio: :table]] 注解 。 


注意 事项 : 


问题 一 : 当 数 据 表 中 存在 数据 后 ， 对 表 结 构 添 加 新 字段 后 ， 发 
现 无 法 读 取 数 据 。 解决 办 法 : ”备份 或 删除 原 有 数据 ， 修 改 完 
数据 结构 体 后， 再 将 数据 导入 进来 。 


问题 二 : 定义 数据 结构 体 时 ， 如 何 选择 使 用 什么 数据 类 型 ? 解 
决 办 法 :， 智 能 合约 所 可 以 使 用 的 数据 类 型 主要 分 为 两 种 : 第 
一 种 为 C++ 语言 本 喘 所 文 持 的 基础 数据 类 型 ， 大 家 可 能 过 
http:/www.cplusplus.com 网 站 进行 查询 ;另外 一 种 ， 便 是 
EOS 上 所 封 儿 的 数据 类 型 ， 可 能 过 
https:/eosio.github.io/eosio.cdt/1.3.2modules.html 网 站 进行 
查询 ， 当 然 也 可 以 通过 cdt 所 提供 的 eoslib 源 码 库 查看 其 源码 实 


现 ， 只 不 过 在 阅读 源码 时 一 定 要 注意 是 查看 的 哪个 版 本 的 实 
现 。 比 如 : 1.3.x vs 1.2.x 版 本 之 前 是 有 很 大 兰 异 的 ， 在 1.3.x 
版 中 束 已 经 弃 用 了 很 多 数据 类 型 。 


第 二 步 、 定 义 索引 器 


在 实现 完 TOKEN 结 构 体 后 ， 接 下 来 需要 思考 并 实现 的 便 是 : 
如 何 定 义 对 数据 的 多 稼 引 数 据 访 问 ? 


比如 : 


。1I) 如 何 通过 主键 进行 数据 查询 ? 
。 2) 如 何 通过 合约 帐户 进行 数据 查询 ? 
。3) 如 何 通过 币 种 合 称 进行 数据 查询 ? 


基于 以 上 功能 需求 点 ， 我 们 将 采用 multi_index 实 现 主键 及 二 
级 索引 定义 的 代码 实现 : 


typedef eoslio::mulLtI_ index< "tokenstruct"”n，token 
Indexed_by< "bysymbol”n，const_mem_fun<tokens 
Indexed_ by< "bycontract”n，const_mem_fun<toke 
> TokenstructIndex 


上 述 代码 实现 了 三 种 查询 方式 : 
。 基 于 主键 


。 基 于 TOKEN 名 称 
。 基 于 合约 名 称 


在 定义 主键 或 二 级 索引 时 ， 需 要 注意 索引 字段 的 数据 类 型 ， 目 
前 主键 数据 类 型 只 支持 uint64 t， 而 二 级 索引 字段 只 支持 
uint64_t、uint128_t、uint256_t、double、long double 五 种 。 


注意 事项 问题 一 : 如 何 实现 对 字符 串 类 型 的 字段 进行 索引 查 
询 ?” 解决 办 法 : 可 在 索引 字段 get 方 法 中 进行 数据 类 型 转换 ， 
比如 将 字符 串 较 为 其 他 文 择 的 数据 类 型 


第 三 步 、 定 义 接 口 方 法 定义 
在 交易 所 合约 hpp 文 件 的 public 代 码 块 中 ， 定 义 TOKEN 功 能 的 
添加 、 修 改 、 删 除 方法 


[Leosio::actionj]j 
vold createtoken(uint64 t token id，string Symbol _ 


[Leosio::actionj]j 
vold updatetoken(uint64 t token_ id，string Symbol _ 


[Leosio::actionj]j 
vold deletetoken(uint64 t token id，string Symbol _ 


同样 ， 在 定义 合约 接口 方法 时 ， 需 要 注意 添加 注解 
[[eosio::action]]， 以 便 生 成 合约 方法 在 ABI 文 件 中 的 定义 。 


第 四 步 、 对 接口 方法 进行 扩展 实现 

上 一 个 步骤 完成 了 对 合约 方法 的 接口 定义 ， 接 下 来 进行 具体 的 
代码 实现 : 

A、 实 现 创建 TOKEN 合约 方法 


vold desert: :createtoken(uint64 t 1d，string symbo 


requlire_auth(_seJlf)， 


//T0D0 1 工 ， 参 数 数据 校 验 


//T0D0 2 ， 业务 数据 校 验 


//T0D0 3， 合约 数据 存储 


整个 数据 处 理 过 程 ， 分 为 三 个 步 骂 : 
1. 参数 数据 校 煌 ， 通过 断言 对 参数 进行 检验 ; 


eoSlo_assert( 1d > 0， "Id not alJLow less than o0| 
eoSlo_assert( Symbol _ name != ””， "Symbol_name nm' 
eoSlio_assert( ext_symbol.get_symbol().1Is _ valid(， 
eoSlo_assert( ext_symboJl ,get_contract() != ”nn 
eoSlo_assert( preclision > 0 ， "preclslion not alj]. 


主要 对 于 一 些 必 填 字 段 ， 以 及 符合 一 定 规范 的 参数 进行 基 
础 数据 校 煌 。 比 如 : 判断 字段 值 是 否 为 宝 ， 判 断 合约 信 筷 
征 合 正确 


2. 业务 数据 校 难 该 部 分 代码 主要 用 于 根据 当前 功能 业务 验证 
其 远 指 正确 性 。 比 如 : 所 要 保存 的 TOKEN 和 名称 是 人 否 已 经 存 
在 、 所 要 保存 的 合约 信息 是 否 已 经 存在 等 等 。 


TokenstructIndex tokenstabJje(_seJlf，_seJf,Vvalue 
auto token_entry = tokenstable.find(1Id ) ， 


eoSlo_assert(token_entry == tokenstabJle,end()，， 


auto Symbol_ index = tokenstable,.get_index<"bysyr 


af+n cvmhnl enf+rwv 二 scvmhnl Tinrev finrndfev+ cs 和 vmhn， 
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eoSlo_assert(Symbol_ entry == Symbol index.end ()， 


3. 合约 数据 存储 当 所 有 数据 校 验 验 证 通过 之 后 ， 便 可 以 对 数 
据 进 行 数据 保存 。 


tokenstabJle.emplace( _Sself，[&l( auto& s ) { 
SENe 人 二 2 必 6 有 
s.Symbol_name = Symbol_name ; 
S.ext_Ssymbol = ext_Ssymbol:， 
s.preclslion = preclsion， 


二 )7 
完整 示例 代码 


vold desert: :createtoken(Cuint64 t 1d，string symbo 
requlire_auth(_seJlf)， 


eoSlio_assert( 1d > 0， "Id not allow less than 
eoSlio_assert( Symbol_name != "””"”，"Symbol_name 
eoSlio_assert( ext_symbolL .get_symbol(),1ISsS_ Valid 
eoSlio_assert( ext_Ssymbol .get_contract() != "”” 
eoSlio_assert( preclsion > 0 ， "precislion not a 


TokenstructIndex tokenstable(_se]lf，_selLf,Vvajlu 
auto token_entry = tokenstable.find(iId ) ， 
eoSlo_assert(token_entry == tokenstabJle.end()， 


auto Symbol _ index = tokenstab]le,get_index<"bys 
auto Symbol_entry = Symbol_ index.find(ext_symb 
eoSlio_assert(Symbol_entry == Symbol index,end ( 


tokenstabJe,emplace( _SseJlf，[&l(C auto& ss ) 二 
Srd 医 三 二 dl 

.Symbol_name = Symbol_name 

,ext_Symbol = ext_Ssymbol; 

.preclslion = preclslion; 


OO WO wm 


B、 实 现 修改 TOKEN 合约 方法 该 方法 在 具体 的 实现 逻辑 上 与 
创建 TOKEN 方 法 相仿 。 


vold desert: :updatetoken(uint64 t 1Id，string symbo 
requlire_auth(_sejlf) ， 


//T0D0 1 ， 参 数 校 验 
//TO0D0O 2 ， 业 务 校 验 
//T0D0O 3 ， 数 据 更 新 


整个 实现 环节 ， 分 为 三 个 步 又 


1. 参数 校 验 
eoSlo_assert( 1d > 0， "Id not alJlow less than o0| 
eoSlo_ assert( Symbol _name != ””， "Symbol _name nm' 
eoSlio_assert( ext_symbol.get_symbol().1Is _ valid(， 
eoSlo_assert( ext_symboJl ,get_contract() != ”nn 
eoSlo_assert( precision > 0 ， "preclslion not alJ]. 


2. 业务 校 难 


TokenstructIndex tokenstabJe(_seJlf，_seJf,value 


auto token_entry = tokenstable.find(1Id) ，; 
eoSlio_assert(token_entry != tokenstabjle.end()，， 


auto Symbol _ index = tokenstable.get_index<"bysyr 
auto Symbol_entry = Symbol index.find(ext_symbo-. 
eoSlo_assert(Symbol entry == Symbol _ index.end () 


3. 数据 更 新 


tokenstabJle.modify(token_entry，_ self，[&]( aut' 
s.Symbol_name = Sympol_name ; 
S.ext_Ssymbol = ext_Ssymbol， 
s.preclslion = preclsion， 
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完整 示例 代码 


void desert: :updatetoken(uint64 t id，string symbo 
requlire_auth(_sejlf) ， 


eoSlio_assert( 1d > 0， "Id not allLow less than 
eoSlio_assert( Symbol_name != "””，"Ssymbol_name 
eoSlio_assert( ext_symbolL.get_symboJlL(),1IS_ Valid 
eoSlio_assert( ext_Ssymbol ,get_contract() != 
eoSlio_assert( preclsion > 0 ， "precision not a 


TokenstructIndex tokenstable(_self，_self.valu 
auto token_entry = tokenstable.find(iId) ， 


eoSlio_assert(token_entry != tokenstabJje,end()， 


auto Symbol _ index = tokenstabjle,get_ index<"bys 


auto symbol_entry 三 symbol_index,find(ext_symb 
eoSlio_assert(Symbol_entry == Symbol index,end ( 


tokenstabJe,modify(token_entry，_ Self，[&]( au 
s,.Symbol_name = Symbol_name ; 
S,ext_Ssymbol = ext_symbol:， 
s,preclslon = preclsion;， 
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C、 实 现 删除 TOKEN 合约 方法 


vold desert: :deletetoken(uint64 t 1d，string symbo 
requlire_auth(_sejlf) ， 


//T0D0 1 ， 参数 校 检 
//T0D0 2 ， 业 务 逻 辑 
//T0D0 3 ， 数 据 存储 


整个 实现 环节 ， 具 体 可 分 为 三 个 步 台 


1. 参数 校 检 


eoSlo_assert( 1d > 0， "Id not alLJlow less than o0| 
eoSsSlio_assert( Symbol_name.length() > 0， "Symbol. 


2. 业务 逻辑 


TokenstructIndex tokenstabJje(_seJlf，_SseJf,Vvalue 


二 ER 


auULO LoKken_entcry = LoKkenSLable,TInd(1Ld ) ; 
eoSlio_assert(token_entry != tokenstable.end()，， 
eoSlo_assert(token_entry->Ssymbol_name == Symboljl. 


此 方法 中 TOKEN 名 称 参 数 ， 主 要 用 于 让 用 户 做 数据 确认 ， 防 
止 对 数据 的 误 删 操作 。 


3. 效 据 存 储 


tokenstab]je,erase(token_entry) ，; 


完整 示例 代码 


vold desert: :deletetoken(uint64 t 1d，string symbo 
requlire_auth(_sejlf) ， 


eoSlio_assert( ld > 0， "Id not allLow less than 
eoSlo_assert( Symbol_name,length() > 0， "Symbo 


TokenstructIndex tokenstable(_se]lf，_seJlLf,Vvajlu 
auto token_entry = tokenstabJle.find(1Id ) ，; 

eoSlio_assert(token_entry != tokenstabJje,end()， 
eoSlio_assert(token_entry->Ssymbol_name == Symbo 


tokenstabJje,erase(token_entry ) ; 


6.4 交易 对 管理 设计 与 实现 
交易 对 功能 设计 与 实现 


上 一 小 节 讲解 并 实现 了 TOKEN 数 据 的 增删 改 ， 那 么 本 小 节 将 _ 
对 这 些 TOKEN 数 据 进行 关系 映射 ， 具 体 数据 表现 形式 就 是 在 
交易 所 中 大 家 所 见 到 的 交易 对 列表 数据 。 如 下 图 所 示 : 


EOS EUSD 


功能 介绍 


交易 对 功能 ， 主 要 用 于 配置 两 个 TOKEN 间 的 映射 关系 、 确 定 
基准 人 下 > 况 换 代 币 、 最 小 订单 量 以 及 和 需要 收取 的 交易 手续 站 


示例 : 假设 : 我 们 需要 创建 一 个 DICE/EOS 的 交易 对 ， 那 么 
基准 代 币 就 是 EOS， 竞 换代 币 就 是 DICE。 因 为 基准 代 币 是 
EOS， 所 以 我 们 可 以 设置 最 小 订单 为 0.1 EOS， 即 不 管 买单 还 
是 卖 单 其 订单 价值 都 不 允许 小 于 0.1EOS 。 同 样 ， 我 们 也 可 以 
设置 交易 手续 费用 为 111000, 即 根据 当前 买 / 卖 单 分 别 收取 或 单 
项 收 到 成 交 订 单 金额 的 1/1000 手 续费 


数据 结构 


字段 数据 类 型 说明 

主键 uint64 t ， 可 自由 设 定 或 由 系统 生成 
兑换 代 币 id uint64 t 

基准 代 币 id uint64 tt 

价格 计算 精度 ， uint32 tt 

最 小 订单 量 uint32 【 

交易 手续 费 uint32 t 


注 : 在 EOS 知 能 合约 中 ， 人 金额 类 型 字段 往往 采用 的 是 由 eoslib 
提供 的 eosio::asset 数 据 类 型 ， 而 在 asset 数 据 类 型 内 部 使 用 的 
是 整 型 字段 ， 考 虑 到 数值 金额 的 方便 计算 少 一 些 数 据 转换 ， 所 
以 我 们 统一 使 用 整 型 字段 ; 另外 ， 因 为 不 同 TOKEN 在 发 行 时 
支持 不 同 精 度 的 ， 所 以 在 涉及 到 金额 相关 字段 都 需要 进行 处 
理 。 


价格 计算 精度 ， 因 为 交易 所 一 般 在 进行 价格 展示 时 默认 是 保留 
小 数 点 后 六 位 ， 所 以 在 价格 计算 精度 配置 是 可 以 设置 为 
1000000， 


最 小 订单 量 ， 需 要 根据 交易 对 中 TOKEN 的 精度 进行 设 定 。 比 
如 : DICE/EOS 交 易 对 对 应 币 种 精度 为 4， 而 我 们 的 最 小 订单 
量 是 0.1EOS, 那么 应 该 最 小 订单 量 应 设置 为 0.1L* 10^4 = 
1000. 


注 : 对 于 数据 类 型 的 选用 ， 一 定 要 根据 实际 业务 需求 权衡 ， 一 
方面 可 以 避免 数值 越界 ， 尤 其 是 对 于 金额 类 型 的 字段 ; 另 一 方 
和 因为 在 合约 中 存储 同样 也 是 需要 文 
一 定 费 用 划 .“ 


业务 约束 

。 仅 人 允许 管理 员 进 行 操作 

。 不 人 允许 重复 交易 对 

。 停 用 交易 对 时 无 法 进行 TOKEN 交 易 
。 判 断交 易 对 代 币 是 否 存 在 

。 已 经 存在 交易 的 交易 对 不 允许 删除 


权限 有 要求 
。 仅 限 管理 员 操作 


安全 问题 
。 权 限 验 证 
。 方 法 分 级 授权 ， 可 根据 管理 角色 进行 授权 。 
技术 实现 


由 项 目 成 员 自主 设计 与 实现 。 
涉及 命 证 令 知 识 点 YY 


。 查 看 Docker 服 务 


docker ps 


。j 进 入 Docker 命 令 窗口 


docker exec -1It <contaliner name> /binvbash 
。 解 镜 钱包 


cleos wallet un1lock -n < 钱包 名 称 > --password < 钱 人 


# 例如 : 打开 名 称 为 hackdappexch 的 钱包 
cleos wallet unjlock -n hackdappexch --password : 


。 发 布 合约 

cleos set contract < 合约 名 > < 合约 目录 > -p < 合约 名 >G@ 
。 调 用 合约 方法 

cleos push action < 合约 名 > < 合约 方法 > [< 参数 1>，< 参 志 


。 查 询 数据 表 


cleos get tab1le < 合约 名 > <scope> < 表 定 义 > 
# Scope 值 取决 于 实例 化 索引 时 所 传 入 的 值 ， 一 般 实 例 化 索引 时 


通过 本 章 世 的 学 习 、 思 考 与 动手 实践 ， 我 们 完成 了 交易 对 功 
能 的 数据 结构 定义 、 创 建 区 易 对 、 修 改 交 易 对 及 删除 交易 对 方 
法 的 代码 开发 与 测 弃 工作 。 


在 教程 中 如 出 现 秒 误 或 不 易 理解 鸭 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail: 
zhangliang@Qcldy.org 


changelog 2019-03-01 zhangliang \zhangliang@Qcldy.orgh' 
。 初次 发 入 


6.5 系统 配置 管理 设计 与 实现 
系统 配置 功能 设计 与 实现 


本 小 节 主 要 讲解 交易 所 所 有 业务 逻辑 中 需要 用 到 的 全 局 配置 数 

据 定 义 与 维护 。 比 如 : 对 交易 所 进行 业务 升级 时 锁定 交易 所 ， 

暂 停 所 有 业务 操作 ;接收 手续 费 的 帐户 等 。 

功能 介绍 

系统 配置 功能 : 主要 用 于 维护 交易 所 束 体 业务 所 需 的 全 局 配置 

参数 定义 。 

示例 : 

。 交易 所 准备 升级 维护 时 ， 可 能 通过 修改 系统 配置 中 的 运行 
状态 字段 即 可 。 


数据 结构 

字段 数据 类 型 说 明 

0: 运行 中 : 1: 已 暂停 。 缺 
运行 状态 bool 举 为 0 

手续 费 系统 接 交易 所 自己 的 帐户 ， 用 于 
政 帐户 ecsioxsname 筑 一 接收 手续 费 


注 : eosio: :name 为 eoslib 提 供 的 数据 类 型 。 值 内 容 字 符 长 度 不 
人 多 许 超过 12 位 。 


业务 约束 
。 仅 限 合约 管理 员 操作 


安全 问题 

。 权 限 验 证 

。 方 法 分 级 授权 
可 根据 管理 角色 进行 细 粒 度 方法 权限 授权 ， 确 保 关键 业 务 
由 高 级 别管 理 员 控制 。 比 如 :对 于 资金 的 提现 功能 只 允许 
最 高 级 别管 理 员 操作 ， 而 合约 的 基础 数据 操作 可 交 由 运 维 
管理 员 进 行 操作 。 


技术 实现 
由 项 目 成 员 自主 设计 与 实现 。 


注 ， 因 为 系统 管理 并 不 像 其 它 功能 需要 存储 多 条 记录 ， 所 以 可 
以 采用 单 例 的 方式 来 获取 系统 参数 。 


参考 知识 局 
单 例 存储 与 查询 


# 示例 : 
// 定 义 单 例 
typedef Singleton< "exchangecfg"”n，configstruct> 


// 实 例 化 
CfgHeJper cfgd_heJlper(_seJf，_selLf.value ) ; 


// 赋 值 
configstruct cfg = configstruct( ) ， 
cfghelper.set(cfg，_self) ，; 


cfgheJper ,get() ; 


命令 方法 
。 查 看 Docker 服 务 


docker ps 


。j 进 入 Docker 命 令 窗口 


docker exec -1t <contaliner name> /binXbash 
。 解 镜 钱包 
cleos wallet un1lock -n < 钱包 名 称 > --password < 钱 反 


# 例如 : 打开 名 称 为 hackdappexch 的 钱包 


cleos wallet unjlock -n hackdappexch --password : 


。 人 发布 合 约 


Cleosseteontracte 各 约 各 演 攻 各 约 目 对 司 二 交 才 各 私 名 20 


。 调用 合约 方法 


Claospushiactaoh 有 鸭 名 全 的 方 二 司 | 玫 会 


。 碍 询 数据 表 


cleos get tab1le < 合约 名 > <Scope> < 表 定 义 > 


ET 人 


## SCOPe 人 但 惧 伏 卫 头 侈 化 条 了 有 六 公信 且 和 伸 ， 役 头 例 化 条 了 有 册 


通过 本 章 和 的 学 习 、 思 考 以 及 动手 实践 ， 我 们 完成 了 系统 配 
置 的 数据 定义 给 维护 工作 。 


在 教程 中 如 出 现 和 误 或 不 易 理解 时 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Malil: 
zhangliang@Qcldy.org 
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6.6 帐户 资金 管理 设计 与 实现 
资金 管理 功能 设计 与 实现 


本 小 节 主 要 讲解 在 交易 所 中 如 何 实现 对 用 户 痪 金 的 数据 管理 。 
当 用 户 进行 不 同 币 种 的 充值 或 者 提现 操作 时 ， 如 何 维护 对 应 数 
据 信 息 、 数 据 结 构 应 该 如 何 设计 以 及 在 开发 过 程 可 能 会 遇 到 哪 


些 安全 问题 。 


功能 介绍 
资金 功能 ; 主要 用 来 管理 交易 所 用 户 在 充值 与 提现 过 程 对 其 幅 
户 数据 的 实时 更 新 。 


示例 : ” 当 用 户 A 进 行 EOS 充 值 时 ， 区 易 所 应 及 时 更 新 用 户 的 
EOS 总 金额 ， 当 用 户 B 进 行 DICE 提 现时 ， 交 易 所 需要 判断 其 
提现 金额 是 否 超出 其 可 用 金 笑 ， 因 为 当 用 户 进行 下 单 时 会 锁定 
用 户 质 金 ， 这 样 用 户 可 导出 的 和 货 金 金 括 为 总 金 笑 减 去 冻结 金 
额 。 


数据 结构 

字段 数据 类 型 ”说明 

总 金 eosio: 

额 :asset 骸 记 总 金 筑 

冻结 eosio: 比如 : 刚 创建 订单 时 需要 冻结 对 应 
金额 Se 订单 余额 。 


注 : 在 实际 开发 时 ， 可 以 考虑 按照 用 户 维度 进行 帐户 资金 隔 
离 ; 也 可 以 将 所 有 用 户 的 币 种 金额 掖 一 个 维度 进行 存储 。 


约束 条 件 


。 仅 限 合约 管理 员 操 作 

。 充值 时 时 需要 币 种 对 应 合约 触发 transfer 事 件 来 进行 充值 ; 
交易 所 不 允许 给 目 己 充值 

充值 时 接收 地 址 必须 为 区 易 所 本 刁 

转帐 金 括 必须 大 于 0 

交易 所 锁定 状态 时 无 法 进行 充值 与 提现 

。 充值 或 握 现 币 种 必须 存在 

。 提 现金 额 必须 小 于 等 于 可 用 金额 “总 金额 -冻结 金额 


安全 问题 


。 权 限 验证 

。 方 法 分 级 授权 
可 根据 管理 角色 进行 细 粒 度 方法 权限 授权 ， 确 保 关 键 业 务 
由 高 级 别管 理 员 控 制 。 比 如 : 对 于 资金 的 提现 功能 只 人 允许 
最 高 级 别管 理 员 操作 ; 而 合约 的 基础 数据 操作 可 交 由 运 维 
管理 员 进 行 操 作 。 

。 由 transfer 事 件 触发 的 币 种 充值 ， 需 要 验证 币 种 对 应 的 合约 
为 合法 合约 。 例 如 : 充值 EOS 则 需要 验证 transfer 消 息 是 来 
自 eosio.token 人 合约。 


涉及 命令 知识 操 


。 查 看 Docker 服 务 


docker ps 


。j 进 入 Docker 命 令 窗口 


docker exec -1It <contalner name> /biInvbash 


。 解 锁 钱 包 
cleos wallet unlock -n < 钱包 名 称 > --password < 钱 反 


# 例如 : 打开 名 称 为 hackdappexch 的 钱包 
cleos wallet unjlock -n hackdappexch --password : 
。 发 布 合约 


cleos set contract < 合约 名 > < 合约 目 永 > -p < 合约 名 >G 


。 调用 合约 方法 


cleos push action < 合约 名 > < 合约 方法 > [< 参数 1>，< 参 


。 查询 数据 表 


cleos get tab1le < 合约 名 > <scope> < 表 定 义 > 
# Scope 值 取决 于 实例 化 索引 时 所 传 入 的 值 ， 一 般 实例 化 索引 时 


通过 本 章节 的 学 习 、 思 考 以 及 动手 实践 ， 我 们 完成 了 对 用 户 
换 金 的 充值 、 提 现 功能 。 


在 教程 中 如 出 现 销 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail 
zhangliang@Qcldy.org 
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6.7 用 户 订 单 管理 设计 与 实现 
订单 功能 设计 与 实现 


本 小 节 主要 讲解 如 何 设计 与 实现 交易 所 中 的 买单 、 卖 单 功能 。 
比如 ， 如 何 定义 订单 数据 结构 、 约 束 条 件 、 与 资金 表 订单 薄 之 
前 有 哪些 级 联 操作 等 等 。 

功能 介绍 


订单 功能 : 主要 用 于 实时 接收 与 存储 用 户 买 卖 单 请 求 并 在 搓 合 
成 功 或 取消 订单 时 更 新 订单 状态 。 


数据 结构 
用 户 说 
单 ”字段 数据 类 型 明 
主键 id ，uint64 {t 由 系统 生成 
1 有 订单 类 型 : pairidx*100+1 为 


| 买单 ，paijrid*100+2 为 卖 音 
薄 id Uint64 { 


单价 Uint64 ft 


人 
人 eoslo::asset 
重 


用 户 说 


订单 ”字段 数据 类 型 明 
表 

未 成 

全 eoSsio::asset 

易 量 

备注 ，string 

创建 eosio: :time 

时 间 _polnt _sec 

订单 | ，， 状态 类 型 ， 完 成 成 交 ， 部 分 
状态 成 交 ; 取 应 订 单 ; 


1. 订单 类 型 ， 之 所 以 使 用 pairid*100+1 或 pairid*100+2 的 方 
式 来 定义 。 是 为 了 将 交易 对 信息 、 严 / 卖 类 型 合 在 一 起 ， 可 
以 巧妙 的 使 用 EOS 答 能 合约 的 存储 方式 来 模拟 买 、 卖 队 
列 ， 从 而 解决 订单 浒 数据 存储 及 搓 合 排序 的 问题 。 


订单 说 
划 考 字段 数据 类 型 攻 
uint64 tt 由 系统 生成 

用 户 人 

关联 用 户 订单 ， 搓 合成 功 
uint64 1 后 方便 状态 更 新 

订单 买 入 或 卖 出 的 兑换 代 币 。 


e0OSI0::aSSet 比如 ; 


重 2311.2341 DICE 


订单 说 
薄 卖 字段 数据 类 型 明 


4 人 部 换代 而 的 准 代 币 
下 单 ，eosio : 

时 间 ，:time_point _sec 

备注 ，string 


订单 单价 ， 在 交易 对 功能 设计 与 实现 章节 曾经 介绍 过 关于 价格 
精度 字段 的 设置 ， 所 以 在 此 处 的 值 也 是 根据 交易 对 配置 来 进行 
设置 的 。 比 如 : 0.128592 单 价 在 存储 时 会 转换 为 128592, 即 乘 
以 100000。 


业务 约束 


。 征 否 满足 交易 对 最 小 订单 金额 
。 订单 金额 是 否 小 于 等 于 帐户 可 用 余额 
。 订单 金 括 是 否 大 于 0 

。 订单 所 属 交 易 对 坪 否 存在 


安全 问题 


。 权限 难 证 

。 方法 分 级 授权 
可 根据 管理 角色 进行 细 粒 度 方法 权限 授权 ， 确 保 关 键 业务 
由 高 级 别管 理 员 控制 。 比 如 : 对 于 资金 的 提现 功能 只 允许 
最 高 级 别管 理 员 操 作 ;， 而 合约 的 基础 数据 操作 可 区 由 运 维 
管理 员 进 行 操 作 。 


技术 实现 


由 项 目 成 员 自主 设计 与 实现 。 
参考 知识 点 

智能 合约 

订单 类 型 生成 规则 


UlInt64 t gen_buytype_bypair(uint64 tt palir_ Id)1{ 
return palr 1d*100 + 工 ; 


UlInt64 t gen_sellLtype_bypair(uint64 tt pair _ Id)({ 
return palr 1d*100 + 2 ; 


】 
订单 薄 队 列 的 实现 方式 


orderIndex buyorderstabJe(_seJlf，gen_buytype_bypail 


orderIndex sellorderstabje(_seJf，gen_selLLtype_byp 


什 


六 


。 查 看 Docker 服 务 
docker ps 


。j 进 入 Docker 命 令 窗口 


docker exec -1It <contalner name> /Xpbin/Xbash 


。 解 饭 钱 包 


cleos wallet unlock -n < 钱包 名 称 > --password < 钱 反 


# 例如 : 打开 名 称 为 hackdappexch 的 钱包 
cleos wallet unjlock -n hackdappexch --password : 


。 发 布 合 约 

cleosEseteecontraee 二 有 你 站 国生 有 目下 > 门生 多 各 > 
。 调 用 合约 方法 

cleos push action < 合约 名 > < 合约 方法 > [< 参数 1>,，< 参 


。 查 询 数据 表 


cleos get tab1le < 合约 名 > <scope> < 表 定 义 > 
# Scope 值 取决 于 实例 化 索引 时 所 传 入 的 值 ， 一 般 实例 化 索引 时 


通过 本 章节 的 学 习 以 及 动手 实践 ， 我 们 理解 并 掌握 了 对 交易 所 
整个 用 户 买 卖 订单 的 内 部 实现 业务 逻辑 并 完成 了 整个 订单 功能 
(创建 严 单 、 创 建 卖 单 、) 的 代码 实现 。 


在 教程 中 如 

出 现 错误 

或 不 易 理 解 

的 知识 点 ， WeChat: Mail: 
欢迎 加 我 微 |， rushking2009 | zhangliang@cldy.org 
信 指 正 ! 

Name: 

zhangliang 
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6.8 订单 薄 搓 合 设计 与 实现 


返 合 功 能 设计 与 实现 

本 小 节 主要 介绍 在 交易 所 的 关键 功能 即 搓 合 业务 。 如 何 检查 订 
单 队列 中 是 否 存在 可 以 搓 合 的 订单 ? 搓 合 的 条 件 是 什么 以 及 在 
接合 过 程 需要 注意 哪些 细节 呢 ? 本 小 节 将 带 你 了 解 其 内 部 实现 
细节 。 


注 : 本 交易 所 项 目 目前 只 文 持 限 价 交 易 。 


功能 介绍 

搓 合 功能 : 主要 当 检 查 到 订单 蒲 队 列 中 出 现 买 单价 高 于 卖 单 价 
的 订单 时 ， 目 动 触 发 搓 合 逻辑 。 根 据 搓 合成 交 量 同步 更 狐 订 单 
溥 、 用 户 订 单 、 资 金 信息 并 上 自动 将 成 交代 币 转帐 至 对 方 帐 吕 的 
一 整套 完整 流程 。 

示例 : 在 交易 所 中 捞 合 过 程 中 ， 往 往 会 遇 到 以 下 四 种 情况 〈 限 
价 交 易 ) : 

完全 成 交 ， 价格 相同 买方 : 以 0.01EOS 单 价 购 买 100 个 DICE 
卖方 ， 以 0.01EOS 单 价 售 卖 100 个 DICE 当 搁 合成 功 后 ， 刚 买 
方 获 得 100 个 DICE， 而 卖方 获得 1 个 EOS 。 

完全 成 交 ， 价格 不 同 买方 : 以 0.02 EOS 购 买 100 个 DICE 卖 
方 : 以 0.01 EOS 售卖 100 个 DICE 当 搁 合成 功 后 ， 则 买方 获得 
100 个 DICE， 卖 方 获 得 1IEOS， 交易 所 获得 1IEOS 。 


部 分 成 交 ， 价 格 相同 买方 : 以 0.01 EOS 购 买 100 个 DICE 卖 
方 : 以 0.01 EOS 售 卖 50 个 DICE 当 挠 合成 功 后 ， 则 买方 获得 
0.5EOS、50DICE， 卖方 获得 0.5EOS。 而 严 方 订单 薄 中 还 有 
0.5 个 EOS 未 成 交 


部 分 成 交 ， 价 格 不 同 买方 : 以 0.02EOS 购 买 100 个 DICE 卖 

方 : 以 0.01EOS 售卖 50 个 DICE 

当 搓 合成 功 后 ， 则 买方 获得 0.01EOS、50DICE， 卖方 获得 

交易 所 获得 0.5EOS; 而 买方 订单 沽 还 有 1 个 EOS 未 
公 O 


业务 约束 


。 搁 合 天 、 卖 订单 必须 币 种 一 至 
。 搁 合 天 单价 格 必 须 大 于 或 等 卖 单价 格 
。 搁 合 订 单 时 需 同步 更 新 订单 薄 、 用 户 订单 、 货 金 数据 。 


业务 流程 


1. 通过 后 端 中心 化 服务 检查 所 有 交易 对 的 严 、 卖 单 队列 ， 按 

照 价 格 优 移 时 间 优 先 的 策略 检查 是 否 存在 匹配 的 订单 

. 存在 则 调用 智能 合约 搓 合 方法 

. 检查 杰 合 的 严 、 卖 订单 价格 和 否 符合 : 买单 价 大 于 等 于 卖 

单价 格 

检查 搓 合 的 买 、 卖 订单 币 种 是 否 一 至 

5. 检查 交易 对 是 否 存在 

On 
部 分 成 区 

7. 根据 成 交 量 更 新 订单 薄 订 单 交 易 量 

8. 根据 成 交 量 更 新 用 户 订单 交易 量 及 状态 信息 

9. 解锁 买卖 双方 帐 尸 谍 结 资金 ; 

10. 更 新 买卖 双方 帐户 余额 

11. 将 成 区 量 的 代 币 直 接 转 帐 到 对 方 帐号 

12. 生成 搓 合 日 志 记 录 同 步 到 链 上 


安全 问题 
。 权 限 验 证 , 仅 限 搓 合 业务 管理 员 进行 操作 。 


CD 让 


。 方法 分 级 授权 
可 根据 管理 角色 进行 细 粒 度 方法 权限 授权 ， 确 保 关 键 业务 
由 高 级 别管 理 员 控制 。 比 如 : 对 于 资金 的 提现 功能 只 允许 
最 高 级 别管 理 员 操 作 ;， 而 合约 的 基础 数据 操作 可 区 由 运 维 
管理 员 进 行 操 作 。 


技术 实现 
由 项 目 成 员 自主 设计 与 实现 。 


涉及 命令 知识 氮 


。 查 看 Docker 服 务 
docker ps 
。 进 入 Docker 命 令 窗口 
docker exec -1It <container name> /bin/vbash 


解锁 钱包 


cleos wallet unlock -n < 钱包 名 称 > --password < 钱 和 人 
# 例如 :打开 名 称 为 hackdappexch 的 钱包 
cleos wallet unjlock -n hackdappexch --password : 


cleos set contract < 合约 名 > < 合约 目 永 > -p < 合约 名 > 人 @ 
。 调 用 合约 方法 


cleos push action < 合约 名 > < 合约 方法 > [< 参数 1>，< 参 志 


。 查询 数据 表 


cleos get tab1le < 合约 名 > <scope> < 表 定 义 > 
# Scope 值 取决 于 实例 化 索引 时 所 传 入 的 值 ， 一 般 实 例 化 索引 时 


通过 本 草 下 的 学 习 以 及 动手 实践 ， 我 们 掌握 了 整个 搁 合 的 详 
细 业 务 逻 辑 并 且 实 现 了 搓 合 业务 方法 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail 
zhangliang@Qcldy.org 
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。 初次 发 称 


第 7 章 后 端 服务 开发 (NodeIExpress) 


7.1 章节 人 简 述 

<< 后 端 服务 开发 >> 本 章节 将 分 为 两 部 分 内 容 进 行 讲 解 : 第 一 部 
分 主要 从 技术 角度 讲 ， 基于 Node.js 如 何 整合 业务 系统 中 所 需 
要 集成 的 各 种 web 服 务 组 件 ， 比 如 定时 调度 引擎 、 多 环境 配置 
(yamh)、 日 志 框 架 、socket、eosjs 等 ， 第 二 部 分 主要 从 业务 角 
度 讲 ， 如 何 根据 实际 业务 需求 在 现 有 技术 框架 如 何 设计 与 实现 
各 个 业务 模块 ， 并 最 终 能 够 对 外 提供 前 端 服务 所 需 的 http 及 
socket 接 口服 务 ， 诸 如 : K 线 图 实时 报表 数据 接口 ， 交易 所 区 
易 对 实时 价格 接口 等 。 


第 一 部 分 、 技 术 组 件 集成 


。 整 合 Express 

。 针对 不 同 环境 切换 配置 

。 集 成 日 志 框架 ， 实 现 调试 与 线 上 不 同日 志 的 处 理 

。 集成 eosjs， 方便 与 私 链 的 数据 查询 及 交易 签名 等 

。 集成 调度 ， 方 便 定 时 调度 区 块 同 步 数据 等 
第 二 部 分 、 业 务实 现 

。 搓 合 调度 功能 设计 与 实现 

。 区 块 同 步 功 能 设计 与 实现 

。K 线 图 报表 功能 设计 实现 

。 实 时 币 价 功能 设计 与 实现 


通过 本 章节 的 学 习 、 思 考 与 实践 ， 大 家 可 以 从 整个 开发 周期 ， 
学 会 如 何 能 根据 实际 业务 需求 选择 合适 的 技术 组 件 ， 学 会 如 
何 与 EOS 链 环境 间 的 RPC 区 互 以 及 交易 签名 等 ， 最 后 根据 交 
易 所 功能 需求 文档 完成 对 外 服务 接口 的 实现 。 


在 教程 中 如 出 现 销 旋 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackiHook 和 
急 es 筷 才 四 矶 加 速 览 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 


changelog 
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。 安 次 发 祝 


7.2 基础 框 桨 整合 
(Express\Node\Log\Profile\Socket) 


技术 框架 整合 

本 小 节 主 人 介绍 如 何 基于 Node.js 构 建 一 个 标准 化 的 web 项 

目 ， 并 在 此 基础 上 集成 http/socket、 定 时 调度 、 日 志 框架 、 多 
环境 配置 、 时 间 处 理 以 及 测试 组 件 。 


一 、 构 建 项 目 工程 


本 项 目 工程 我 们 将 选用 Express 框 架 作 为 web 服 务 框架 ， 
Express 是 基于 NodeJjs 平台 ， 快 速 、 开 放 、 极 简 的 Web 开 


发 框架 。 
Web 应 用 程序 API 性 能 框架 
Express 是 一 个 保持 最 小 规模 的 灵 使 用 您 所 选择 的 各 种 HTTP 实用 工 Express 提供 精简 的 基本 Web 应 许多 流行 的 开发 框架 都 基于 
活 的 Nodejs Web 应 用 程序 开发 具 和 中 间 件 ， 快 速 方便 地 创建 强大 用 程序 功能 ， 而 不 会 隐藏 您 了 解 和 Express 构建 。 
框架 ， 为 Web 和 移动 应 用 程序 提 的 API。 青睐 的 Nodejs 功能 。 
供 一 组 强大 的 功能 。 


在 开始 之 前 ， 请 先 确保 自己 的 电脑 已 经 安装 了 Node.js， 因 为 
后 续 的 操作 需要 用 到 npm 命 令 来 帮助 我 们 快速 安 厂 各 个 依赖 组 
件 。 

1. 新 建 工 程 


> mkdir dexchange_web 
> cd dexchange_web 


2. 初始 化 并 配置 Node 工 程 
通过 npm_ init 命令， 设置 我 们 工程 的 基本 属性 ， 比 如 初始 


版 本 信息 、git 仓 库 地 址 、 作 者 、 工 程 介 绍 等 信息 ， 配 置 完 
成 后 会 目 动 生 成 到 package.json 文 件 。 


> npm Inzit 

package name: (dexchange_web ) 
version: (1.0.0) 

description: 

entry polint: (index.,]js) 

test command : 

dit reposiItory : 


keywords : 
author : 
License: (IScC ) 
Abpout to write to .,,,.，,， /dexchange_web/vpackage ., 
{ 
"name"”: "dexchange_web "， 
NSS 69 
desCiaainOIniae an 
“maln : "1Index.]js ， 
ES GBS 人 
"test"”: ”echo \"Error: no test SpecifiliedN\” 
】， 
TU 
"License"”: "ISC"” 


你 也 可 以 在 工程 根 目 未 下 ， 打 开 package.json 文 件 查 看 具 
体 配 置信 息 。 


3. 安装 express 
通过 npm install 命 令 快速 安装 express 组 件 ， 并 将 组 件 信息 


写 入 package.json 文 件 中 。 


> npm Instal]1 express --Save 


4. 创建 web 服 务 
在 工程 目录 下 ， 创 建文 件 ， 作为 程序 运行 的 入 口 局 动 文 
件 。 然 后 ， 烙 贴 以 下 代码 到 index.js 文 件 中 


Var 
Var 
Var 
Var 


express = redqulire( ' express ' ) 

app = express'( ) 

http = redulire(' http ' ) .Server(app ) 
router = express.Router( ) 


const port = 3000 


app ， 


人 


al('* ，function (red，res，next) 1 
res,header( 'Access-Control-AJLLow-origin ， 
res,header( 'Access-Control-ALLow-Headers '， 
res,header( 'Access-Control-ALLow-Methods '， 


If (req,.method == OPTIONS  ) { 
res,Ssend(200 ) 

} else 1{ 
next'( ) 

】} 


router ,get( :name'"，async function (req，res) : 


res,SetHeader( ' Content-Type"， :application， 


res,json({ 
StatuSs: "OKk'"， 


3+na ren naramc name 


9 
app,use('/'，router ) 


app,use(function (red，res，next) 并 
res,Status(404).Send("Sorry，that route doe: 
上 ) 
http. LIsten(port，Tfunction () 区 
conSsole.iInfo(' istening on :+ port) 


了 ) 


. 运行 程序 
> node Index, js 


. 通过 浏览 器 访问 http:Wlocalhost:3000/xman 


四 目 @ 辆 localhost:3000/xman x “十 
所 C 合 @localhost:3000/xman 

1 // 20190302165729 

2 /A/W http :VyVLocalLhost :3000/Zxman 
3 

4 本 

5 StatuS :7 “四 K ， 

6 "data"”: “Xman” 

7 | 


到 
此 ， 便 完成 了 一 个 最 简单 的 文 持 http 服 务 的 web 框 架 。 接 下 
来 ， 我 们 将 一 个 个 的 集成 socket 组 件 、 日 志 组 件 、 日 期 组 
件 ， 以 文 撑 狐 业 务 需 求 及 线 上 问题 跟 踩 。 


二 、 安 装 组 件 
1. SOCKET 组 件 
A. 安装 
npm install socket.I0 
B. 集成 示例 


1. 实例 化 socketserver 
Var express = redqdulire( ' express  ) 


var app = express() ; 
Var http = _ require( http ).Server(app ) ， 
Var Socketsvr = require( socket .io' )(http ) ， 


// 注 : 如 采 不 特殊 指定 socket 端 口 的 化 ， 将 默认 采用 http 的 闪 | 


2. 建立 socket 连 接 
Socketsvr.on("connection"，function(Ssocket)({ 
/Vsocket 实 例 为 建立 好 连接 之 后 ， 单 通道 实例 
了 ) 


3. 断 开 socket 链 接 
Socketsvr .on("disconnect"，function(socket ){ 


4. 接收 消 轧 〈 单 通道 ) 


socket ,on("klLine,query"”，function(args)({ 
console,.1og(JSON,strify(args ) ) ; 

了 ) 

// 注 : kline,.dquery 为 目 定义 事件 ，args 也 可 能 目 由 进行 设 定 


5. 发 送 消息 〈 单 通道 ) 

Socket ,emit("kJline.Uupdate"”，({ 
"method"”: "kJline.update'"， 
"data": []， 

"params"”: 上 [] 


}) 
// 注 : kline.update 为 自 定 义 事件 ， 返 回 参数 同样 可 以 上 自己 疼 


6. 全 局 广播 
Socketsvr .Sockets.emit("notifyall1"”， 1 
"method"”: "notifyal]”， 
olcnecu si 加 
"params"”: 上 [] 


]) 


C. 在 线 文档 


https://github.com/socketio/Ssocket.Io/blob/dfo5b73bb93d7c34 
c758504001f869cb156703d5/docs/API.md 


D. 下 载 地 址 


https:/www.npmjs.com/package/Socket.I0 


E. 调 试 工 具 


可 通过 Socket,io tester 工 具 可 以 订阅 监听 事件 并 发 送 消息 至 


socker 服 务 器 进行 接口 测试 。 


ee ga socketiotaster | 
hapysockceso- x ， 
条 http://socketjo-chat.now.sh 
Send Message ER ED 
typin9 FE 
Message arguments Type: Object 
六 Message: 
PE [一 -9 pgeject fugerngsc: “covcoo" 上 
JSON 
En bpm cea 
Tuesyfhpeni "035 ) FT 
Type: Object 
Message: 
ppject furorrsecil "coucoo 
Event: User joined 15:18.20 
Argument 1 
| Type: Object 
] p geject fvzernsae: "kevceu"，noeuzersy 了 4) 
Listen for events 
站 5:16:47 
他 ,Bo 本 Event: typing 45:16-4: 
2 add usel Argument 1 
SC 汪 Type: JSON 
忆 yping X Message: 
区 userjoined 其 objecr furernamer “socket 
忆 stop yping 其 Argument 2 
Type: J 
Stop typing Pick acoOf 
区 到 本 Message: 
Event: user joined 15-1622 


下 载 地 址 : http:Welectronjs.org/apps/socket-io-tester 


2. JSON 请 求解 析 


该 组 件 主要 用 于 解析 请 求 内 容 为 application/ison 类 型 的 数据 


A. 安装 


> npm Install body-parser 


B. 集成 示例 


app.Uuse(bodyParser ,Urlencoded(({ 
extended: fajlse 


让) 


app.use(bodyParser ,json( ) ) ; 


C. 在 线 文档 
https://github.com/expressjSs/body-parser#readme 
D. 下 载 地 址 
https:/www.npmjs.com/package/body-parser 


3. 多 配置 


实现 多 环境 配置 ， 文 持 开 发 、 测 斌 环境、 正式 环境 不 同 配置 的 
灵活 切换 。 


A. 安装 


> npm Install1 nconf 
> npm instal]1 js-yamJ] 


B. 集成 示例 


const nconf = requlire("nconf ”) 
const yam]l = reduire("”js-yam]1"”) 


nconf .file({ 
file: cfgpath，V// 可 通过 NODE_ENV 的 方式 加 载 不 同 配置 
format: { 
parse: yam],SafeLoad ， 
Stringify: yam1L .SafeDump， 


了 


nconf .get'( ) 


C. 在 线 文档 
https://github.com/indexzero/ncon 全 readme 
D. 下 载 地 址 
https:/www.npmjs.com/package/nconf 
https:/www.npmjs.com/package/S-yaml 

4. 日 期 组 件 


date-fns 坪 一 个 提供 了 丰富 的 处 理 时 间 方 法 的 工具 库 。 比 如 : 
格式 化 时 间 、 日 期 计算 、 日 期 比较 等 等 。 


A. 安装 


npm instalLl date-fns --Save 
or with yarn 

yarn add date-fns 

or With bower 

bower InstallL date-fns 


B. 集成 示例 
1. 日 期 格式 化 


dateFns .format(new Date(2014，1I，11)， -MMXZDDVZYY” 


V 村 V 间 V 


2. 日 期 比较 
var_ result = ISAfter(new Date(1989，6，10)，new 


3. 计算 开始 时 间 


// The start of aa second for 1 December 2014 22 
Var result = StartoOofSecond(new Date(2014，11， 工 
//[/=> Mon Dec 01 2014 22:15:45 .000 


4. 日 期 计算 
// Add 10 days to 1 September 2014 : 
var result = addDays(new Date(2014，8，1)，10) 
//=> Thu Sep 11 2014 00:00:00 


C. 在 线 文档 
https://date-fns.orgv1.30.1/docs/startOfSecond 


D. 下 载 地 址 


https:/www.npmjs.com/package/date-fns 


5. 日 志 组 件 
A. 安装 


> npm instal1 winston 
> npm _ install winston-daily-rotate-f1lile 


B. 集成 示例 


const { createLogger，Tformat，transports } = reduil 
const { 人 combine，timestamp，Jlabel，printf } = form 
const path = reduire(' path  ) 

const fs = reduirel( ' fs -) 

requlire( winston-daliJy-rotate-file ') 


const Logger = createLogger(({ 
format : Combine( 


abe]((!{ 
abe1 : "dexchange#' + path.basename 
汪 厅 
format ,Spat()， 
format ,colorlize()， 
timestamp({ 
format : "YYYY-MM-DD HH:mm:Sss， 


史记 


printf(info => { 
let msg = Info,message 
本 ESY 人 
If (Info,message Instanceof Object 
msgq = JSON.Sstringify(Info,mess 
】} 
catch (error ) 革 
msgq = Info.message ; 
) 
return “`${info.timestamp} [$ftinfo,Labe 
了 ) 
)， 
transports: [ 
new transports.Console(({ 
Jeve]l: cfg.console. LeveJ] 
了 )， 
new(transports.DaliJyRotateFIJe)({ 
level: cfg.flle.leveJ]， 
filename: path. join('` 1ogs ，cfg.file 
datePattern: cfg,file.datePattern， 
ZippedArchive: cfg.file.zippedArchiv 
maxS1lIze: cfg.flile.maxs1l1ze， 
maxFiles: cfg.file.maxFiIJles 
3 


] 
有 7 


C. 在 线 文档 
https://github.com/wlinstomjs/winston#table-of-contents 
D. 下 载 地 址 


https:/www.npmjs.com/package/winston 
https:/www.npmjs.comy/package/winston-dally-rotate-flle 


6. 数据 库 及 连接 池 


本 项 目 中 我 们 将 采用 mysql2 作 为 项 目的 数据 库 ， 而 mysedquel 
组 件 主要 是 为 了 提升 查询 效率 ， 而 引入 的 数据 库 连 接 池 ， 防 止 
频 党 的 创建 数据 库 连 接 。 


A. 安装 


> npm Instal1 mysequel 
> npm instal]1 mysdq]12 


B. 集成 示例 
1. 初始 化 mysqdlI 连 接 池 


const mysequel = reduire( myseduel  ) ，; 


thiIs.mysdql = mysedque(dbconf1ig ) ，; 

thiIs.mysdql,on( :duery-complete ' ，(type，dquery，dl 
Logger,.debug(query， $fttype} query compJete 

了 ) 


thlIs.mysdql,on( ' query-error ' ，(err，type，query， 


1nnner errmnmrf 了 


query 
}，  $ttype}y query failed after $ftdurationym: 


下 


除了 query-complete、query-error 监 听 事 件 外 ， 还 支持 
duery-start、query-retry、query-done 等 等 事件 ， 可 根据 自 
己 的 需求 进行 代码 实现 。 


2. 插入 数据 


thlis.mysdqlL.queryInSsert("insert into USser (1d，Pni 
区 | 二 | 
name: name， 

上 ),then((resulLt) => 1{ 

了 ),.catch((err) => 1{); 


3. 修改 数据 


thlIs.mysdql,queryCchanged("update User Set name = 
Kel 3 Ne 
name: name， 

上 ),then((resulLt) => 1{ 

CaEemttkeinr 天 三 旺 个 

了 ) 


4. 查询 批量 数据 


mysql .query(1{ 
sd1L: :SELECT * FROM Users LIMIT :ImzIit '， 


Values: { Limit: 10 
retry: false 


了 ) 


此 处 只 展示 了 几 个 示例 代码 ， 如 果 有 其 他 需求 可 直接 查阅 官方 
在 线 文档 。 


C. 在 线 文档 
https://github.com/Twipped/myseduel#readme 
D. 下 载 地 址 


https:/www.npmjs.comy/package/myseduel 
https://www.npmjs.comy/package/mysdqdl2 


7. 调度 引擎 
A. 安装 


> npm install node-schedule 


B. 集成 示例 


var Schedule = require( ' node-Sschedule  ) ; 


// 每 个 小 时 的 第 42 分 钟 执行 该 任务 
var ] = Schedule.schedujeJob(': 42 ”functio 
console.,1og( :The answer to Life，the universe，a 


小 ) 


| | | | | -~ uay UL week \U - (1) 
OILELEERE 2 
ERITONEi LE SI 
ES 
minute (0 - 59) 
second (0 -59，0OPTIONA 


C. 在 线 文档 
https://github.com/node-schedule/node-schedule#readme 
D. 下 载 地 址 
https:/www.npmjs.com/package/node-schedule 
通过 本 章 世 的 学 习 、 思 考 以 及 动手 实践 ， 我 们 完成 了 基于 
Nodejs 的 多 技术 组 件 整 合 。 在 此 项 目 中 ， 支 持 多 配置 文件 


(本 地 、 测 斌 环境 、 正 线 环 境 ) 配置 与 发 布 、http/socket、 定 
时 调度 、 日 志 记 录 以 及 按 天 切割 压缩 日 志 等 功能 。 


在 教程 中 如 出 现 销 旋 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackiHook 
急 5 记 才 四 碍 加 速 禹 一 去 中 心 交易 所 


changelog 
2019-03-02 zhangliang 
。 急 次 发 称 
2019-03-12 zhangliang 
。 文 档 目 隶 序 号 完善 
。 完善 文档 介绍 


。 增 加 微 信 和 图片 
。 修 改 邮 箱 链 接 


7.3 技术 整合 -EOSSDK (〈eosjs) 

本 小 节 将 主要 介绍 在 现 有 Node 框 架 服 务 中 ， 整 合 与 链 端 的 服 

务 交 互 。 比 如 : 如 何 访问 链 上 数据 、 如 何 对 合约 中 的 数据 进行 
不 同 字 段 的 排序 与 检索 以 及 如 何 对 执行 方法 的 签名 与 提 区 等 。 


eosjs 是 一 个 基于 EOS 链 节点 HTTP 接 口服 务 封装 的 javascript 
语言 版 本 SDK 实 更。 到 目前 为 止 ， 仅 提供 了 该 语言 实现 。 当 

然 ， 我 们 也 可 以 根据 入 点 所 提供 的 RPC API 进 行 不 同 语言 厂 本 
的 实现 。 


本 项 目 将 适用 于 eosjs@ 16.0.9 版 本 ， 所 以 在 安装 时 需 经 指定 
对 应 版 本 。 


A. 安装 


npm Install eosjso16.0.9 or yarn add eosjsQ16.0.9 


B. 集成 示例 


dk 
const Eos = requlire( 'eosjs ') 


//2.， 实例 化 sdk 

Jet eos = EoSs(({ 
chainId: nuL1L，V// 链 id。 用 于 区 分 不 同 链 网 络 ， 正 式 网 与 : 
keyProvider: ['PrivateKeys,.,'!]，// 签 名 私 钥 列 表 ， 
httpEndpoint: 'http://127.0.0.1:8888'，// 区 块 链 
expireInSeconds: 60， // 交 易 过 期 时 间 
broadcast: true， // 是 否 广播 


]) 


j 7]/a 提 太 真 易 


ZOLSZCuUAEESEEZSS222g 


eos transaction(({ 
actions: [{ 
account : < 合约 帐户 le.g，hackdappexch>， 
Te |EESOREESCULESELTSUE 
authorIzation: [({ 
actor: < 合约 帐户 |e.g，hackdappexch>， 
permission: < 合约 授权 用 户 |e.g，hackdappo 


9 攻 
aaT 多 方 。 全 叉 末 
和 


条 


天 于 Eos 实 例 化 时 所 用 到 的 更 多 可 选 参数 ， 可 从 以 下 链接 中 进 
行 详细 了 解 
https://github.com/EOSIO/Aeosjs/blob/v16.0.9/README.md#c 
onfiguration 


C. 使 用 示例 


1. 查询 合约 数据 
在 实际 业务 的 场景 中 ， 可 能 我 们 需要 查询 链 上 数据 进行 一 
些 业务 处 理 。 比 如 ， 查 询 用 户 的 未 成 交 订 单 或 历史 成 交 订 
单列 表 ， 或 根据 ID 查询 单个 订单 信息 。 


eos ,getTabLeRows ({ 
json: true， 
EU 二 中 忆 


scope: < 数据 范围 | 可 自由 设 定 义 ， 可 以 为 合约 帐户 信息 攻 
tab1le :; < 合约 表 >， 

key_type: < 索引 字段 类 型 |primarykey 为 1， 根 据 自 定 
index_position: < 按 表 中 哪个 字段 进行 索引 查询 或 排序 
1imji+'， 一 查 褒 | 邹 量 限制 |> 


~L ~LIII-~L 一。 TAR RS 


了 ) 


2 执行 合约 访 法 方式 一 ) 


eos transaction(1{ 
actions: [(!{ 
account : < 合约 帐户 le.g，hackdappexch>， 
Ne ESORNEC CEEEE US 
authorization: [!{ 
actor: < 合约 帐户 le.g. hackdappexch>， 
permission: < 合约 授权 用 户 |je.g，hackdal 
站 
data 合约 方法 参数 马 
了 
了 ) 


3 仙 行 合 多 万 二 5 式 二 ) 


// Qreturns {Promise 
eos,Ccontract([contract_name]1，[Loptions]，[LcaJlJb: 


VZA] 单个 方法 执行 
eos,Ccontract( "hackdappexch"”) ,then(mycontract=>1{ 
mycontract ,hnhI("hackdapp”) 


下 


人 
eos transaction([ ' 合 约 一 '， 合 约 二 ']，(contract1， 
Conkeiactdl 晤 站 ( 攻 瑟 9) 


Coneact2RnE) 
AAA 


下 / 
4. 查询 EOS 帐 户 余额 
eos ,getCcurrencyBalance([contract_name]，[contrat 


eos ,getCurrencyBalance( 'myaccount  ， :myaccount ' ， 


D. 在 线 文档 https:Weosio.github.io/eosjs/ 
https://developers.eos.Io/eoslo-nodeos/reference 


E. 下 载 地 址 https:Weosio.github.io/eosjsy/ 
通过 本 小 蔬 的 学 习 、 思 考 与 动手 实践 ， 我 们 学 会 了 如 何 实例 


化 eossdk， 如 何 通过 sdk 访 问 合 约 数 据 ， 查 询 用 户 余额 以 及 交 
易 签 名 等 操作 。 


在 教程 中 如 出 现 销 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail 
zhangliangQ@Qcldy.org 


纺 ee 介 才 四 码 加 速 稚 ~ 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 


changelog 
2019-03-04 zhangliang 


。 初次 发 称 


7.4 搓 合 定时 调度 功能 设计 与 实现 

上 一 小 节 介绍 了 如 何 利 用 eosjs 与 链 进行 数据 交互 ， 那 么 本 小 
节 将 主要 介绍 如 何 定时 和 触发 调度 检查 买卖 订单 消 是 否 存在 搓 合 
订单 以 及 如 何 触发 搓 合 方法 等 。 


功能 介绍 

搓 合 调度 功能 ， 主 要 是 通过 Node 调 度 服务 每 隔 x 分 钟 查询 智能 
合约 所 有 交易 对 的 订单 薄 中 买卖 队列 中 是 否 存在 可 以 搓 合 的 订 
单 ， 当 发 现 有 符合 条 件 的 订单 时 ， 自 动 执行 搓 合 方法 进行 搓 合 
晕 辑 处 理 ， 并 将 接合 后 的 订单 明细 上 链 。 


调度 配置 

调度 实现 是 由 node-schedule 组 件 进 行 实现 的 ， 该 组 件 支持 
cron 表 达 式 配置 。 

权限 要 求 


考虑 到 智能 合约 的 唤 金 和 业务 数据 的 安全 性 ， 需 要 对 智能 合约 
的 方法 进行 分 级 权限 管理 。 所 以 对 于 执行 调度 的 私 钥 只 授权 智 
能 合约 搓 合 方法 的 权限 。 


技术 实现 
对 于 该 功能 主要 分 为 两 部 分 实现 ; 


1. 通过 eosjs 按 照 价格 优先 时 间 优 移 的 策略 对 订单 薄 买 卖 订单 
进行 排序 并 检查 起 否 存在 可 搁 合 订单 。 至 于 排序 的 实现 可 
以 借用 智能 合约 索引 凑 的 特 扣 进行 实现 。 

2. 对 可 搁 合 的 订单 进行 链 上 搓 合 。 对 于 搓 合 数据 上 链 的 实现 
可 能 通过 调用 合约 方法 的 方法 进行 链 上 数据 存储 。 比 如 : 


af+n lnnraf+a 二 accemmhlelnnrnair 1q mraire mrer: 


Sa: SN 
action( 
permisslion_ Level{L _SseJlLf， "actlive"”n 少 
_SelLf， "Log _n， 
std::make_tuple(Jogdata) 
) .Send ()) 


另外 ， 在 调度 的 过 程 中 ， 需 要 对 调度 任务 进行 加 锁 处 理 ， 防 止 
重复 检查 调用 问题 的 出 现 。 如 条 要 进行 多 机 部 署 的 化 ， 需 要 考 
虑 分 布 式 锁 的 实现 。 

如 有 条 还 需要 将 功能 进行 分 离 部 敬 ， 比 如 : 将 报表 接口 服务 、 调 
度 服 务 进行 单独 部 著 ， 那 么 需要 在 司 动 时 需要 文 持 参 数 化 的 配 
汪汪 


相关 知识 点 


Cron EXxpression Generator & Explainer - Quartz 


通过 本 小 世 的 学 习 、 思 考 与 动手 实践 ， 我 们 完成 了 搁 合 订单 匹 
配 功 能 、 提 交 搓 合 交 易 、 定 时 调度 以 及 成 交 订 单 上 链 功 能 。 


在 教程 中 如 出 现 稍 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail 
zhangliang@Qcldy.org 


HackHook 
马 2 息 才 皮 矶 加 汗 党 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 


changelog 
2019-03-04 zhangliang \zhangliang@Qcldy.orgh' 


。 亡 次 发 祝 


7.5 同步 区 块 功 能 设计 与 实现 
上 一 小 节 讲述 了 搁 合 功能 的 业务 实现 ， 那 么 本 小 节 将 介绍 如 何 
发 现 链 上 搓 合 成 交 日 志 ， 如 何 增 量 同 步 订单 数据 至 中 心 化 数据 
库 以 及 如 何 根据 规划 实时 更 新 K 线 图 报表 数据 


功能 介绍 


区 块 同步 功能 ， 


主要 起 通过 定时 调度 ， 实 时 检查 链 上 成 区 订单 


信息 ， 如 采 痢 成 区 订单 则 同步 至 线 下 成 区 订单 库 ， 并 按 一 定 业 
务 规则 更 新 K 线 图 报表 数据 。 


数据 结构 
成 交 订 单 表 
字段 
主键 
交易 对 ID 
成 交 量 
成 交 价 格 
成 交 时 间 
坟 放 | 
买方 价格 
买方 订单 ID 
买方 备 往 


数据 类 型 
bigint 
bigint 
bigint 
blgint 
tiImestamp 
varchar 
bigint 
bigint 


Varchar 


说 明 


字段 


卖方 帐户 
卖方 价格 
肝病 辣 | 本 四 
卖方 备注 

最 后 更 新 时 间 
最 后 更 新 区 块 
K 线 图 报表 
字 ， 数据 
段 类 型 
妇 

| bigint 
1D 

电 bigint 
开 

bigint 
价 

收 


bigint 


数据 类 型 ， 说 明 
varchar 

blgint 

bigint 

varchar 
timestamp 


blgint 


说 明 


按 分 钟 汇总 成 区 订单 数据 
当前 区 间 维 度 开盘 第 一 单 成 交 价 ， 比 如 : 按 


日 线 图 查询 时 ， 大 开盘 半 小 时 内 无 成 交 价 则 
取 前 一 天 收盘 价 ; 


当前 区 间 维 度 最 后 一 单 成 交 价 


数据 | 
类 型 ， 说 明 


了 对 各 还 性 


bigint ， 当 前 区 间 维 度 最 高 价 


价 

最 

低 | bigint | 当前 区 间 维 度 最 低 价 

价 

成 

交 | bigint | 当前 区 间 维 度 总 成 区 量 单数 
量 

调度 配置 

根据 cron 表 达 式 触发 调度 任务 。 
权限 要 求 


同步 功能 只 电 查 询 合约 数据 并 同步 至 本 地 库 ， 对 智能 合约 无 安 
全 性 问题 。 


技术 实现 
本 功能 实现 逻辑 ， 可 拆 分 为 三 个 业务 模块 实现 ; 


1. 如 何 碍 询 链 上 成 区 记录 
查询 链 上 成 交 数 据 ， 原 理 是 通过 调 
用 eos . detAct1ions(contractname，pos，offset ) 力 去 
旬 选 合约 中 的 日 志方 法 ， 从 而 获取 具体 的 成 交 明 细 。 但 需 
要 注意 的 是 提供 碍 询 的 链 世 点 必须 事先 加 载 history_plugin 
插件 ， 否 则 查 到 的 数据 为 空 。 所 以 将 来 部 署 服务 时 ， 需 要 


注意 所 要 链接 的 节点 不 管 是 自己 搭建 还 是 第 三 方 链 结 点 都 
必须 配置 history_plugin 播 件 。 
. 同步 链 上 成 交 记 录 至 本 地 订单 表 
当 查 询 到 链 上 成 交 记 录 后 ， 需 要 增 量 同步 至 本 地 库 。 关 于 
增 量 的 处 理 可 以 根据 当前 库 中 最 后 一 条 记录 的 区 块 ID 与 链 
上 区 块 ID 对 比 处 理 。 
3. 根据 报表 要 求 聚 合成 交 数 据 至 K 线 网 报表 
因为 K 线 图 支持 5 分 钟 、10 分 钟 、 按 小 时 、 按 天 等 不 同 维度 
的 数据 查看 ， 考 虑 到 数据 库 性 能 要 求 ， 我 们 可 以 根据 维度 
对 多 报表 (分 钟表 、 人 小 时 表 、 天 表 ) 进 行 数据 聚合 更 新 。 注 
意 : 在 聚合 数据 时 ， 需 要 开盘 价 、 收 副 价 、 最 高 价 、 最 低 
规则 进行 处 理 后 再 更 新 。 


放 


通过 本 小 万 的 学 习 、 思 考 与 动手 实践 ， 我 们 完成 了 链 上 成 区 订 
单 的 数据 同步 以 及 K 线 图 报表 数据 的 更 新 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackHook 
急 并 介 才 四 矶 加速 鉴 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨 询 。 


changelog 
2019-03-04 zhangliang 


。 初次 发 称 


7.6 K 线 图 报表 功能 设计 与 实现 


本 小 地 我 们 将 介绍 如 何 实现 对 外 K 线 图 报表 数据 查询 ; 当 发 生成 
交 订 单 时 ， 如 何 实时 推送 报表 数据 至 前 病 展 示 页 。 


功能 介绍 

K 线 图 报表 功能 ， 主 要 用 于 按照 用 户 所 选择 的 不 同 维度 K 线 图 
进行 不 同 报表 数据 展示 ;， 当 有 新 成 交 订单 时 按照 推送 最 新 K 线 
数据 至 前 端 页 面 。 


接口 服务 


查询 报表 数据 
文 持 5 分 钟 、30 分 钟 、 小 时 、 天 四 种 维度 的 K 线 岁数 据 展 示 
触发 条 件 : 


1. 当 用 户 第 一 次 进行 交易 所 时 ， 需 要 根据 当前 报表 维度 (分 、 
时 、 天 ) 查询 固定 时 间 段 报表 数据 

2. 当 用 户 切 换 交 易 对 时 ， 需要 根据 报表 当前 维度 (分 、 时 、 
天 ) 碍 询 固定 时 间 段 的 报表 数据 

3. 当 用 户 拖 动 K 线 岁 时 ， 需 要 根据 当前 维度 查询 不 同时 间 段 的 
报表 数据 


数据 接口 
。 请 求 参数 : 
对 
"begintime": ""，V// 查 询 时 间 区 间 〈 开 始 ) : 2019-6 


nenr+imen':， nn /7V/ 查 论 | 时 间 区 间 ( 疆 囊 ) ，2n1Q-6 


IJUM ~ 里 er | N\ 一 上 AT/ 里 一 \V ~Lv/ W 


下 查询 周期 ， 60(1min)、3600(1 


。 提交 方 式 : 
“post 


。 响应 结果 : 


IEGISUIaoes OK 
"data": [ 
["2019-02-01 12:00"，0.021200，0.021200，0. 


推送 报表 数据 
文 持 5 分 钟 、30 分 钟 、 小 时 、 天 四 种 维度 的 K 线 图 数据 推送 
触发 条 件 : 
。 当 监测 到 有 新 成 区 记录 时 ， 需 在 同步 完 区 块 数据 后 ， 增 量 
推送 最 新 的 报表 数据 至 用 户 web 端 
数据 接口 
。 接 口 地 址 (TOPIC) kline.query 
。 请 求 参数 
1. 交易 对 id : 查询 报表 所 对 应 的 交易 对 
2. 开始 时 间 : 报表 展示 开始 时 间 
3. 结束 时 间 : 报表 展示 结束 时 间 


4. 时 间 周 期 : 报表 展示 维度 
。 了 员 应 结果 : ”监听 方法 : kline.query 


method -: "KLine.query 

"data”": [ 
/Atime，clLlose，open，high，]JLow，Vvolume ， 
//( 时 间 ， 收 一 价 、 开 一 价 、 当 日 最 高 价 、 当 日 最 低 价 
["2019-02-01 12:00"，0.021200，0.021200， 

]， 

"params": [1，3600] // 交 易 对 id， 时 间 周 期 


技术 实现 
下井 和 二 水 的 几 横 玫 辣 人 放下 生 度 聚合 后 台 报表 
2. 在 同步 数据 区 块 时 ， 加 入 报表 数据 推荐 的 业务 逻辑 。 


通过 本 小 世 的 学 习 、 是 考 与 动 玫 实 践 我 们 完成 了 K 线 图 的 报 
表 数 据 得 询 与 推送 功能 。 


在 教程 中 如 出 现 销 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackiHook 和 
马 二 所 才 四 三 加 速 和 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 


changelog 
2019-03-04 zhangliang 


。 初次 发 稿 
2019-03-05 zhangliang 
。 完 善 http/socket 数 据 接 口 及 参数 


7.7 实时 币 价 功能 设计 与 实现 

本 人 小节 将 主要 介绍 如 何 实现 当 前 交易 所 所 有 交易 对 币 价 的 http 

数据 查询 ， 比 如 : 当前 价格 、 最 高 价 、 最 低 价 以 及 24 小 时 成 交 
量 等 信息 。 除 此 之 外 ， 还 需要 实现 对 交易 所 展示 页 面 实时 币 价 
的 消息 推送 。 


功能 介绍 
实时 币 价 功能 , 主要 用 于 展示 交易 所 所 有 交易 对 当前 的 市 场 行 
情 ， 并 根据 市 场 交 易 成 交 记 录 实 时 更 新 前 端 页 面 中 的 交易 对 价 
格 及 成 区 量 等 信息 。 
接口 服务 
查询 交易 对 价格 
查询 当前 时 间 所 有 区 易 对 的 币 价 、 涨 跌幅 、 成 区 量 等 信息 。 
触发 条 件 页 面 首 次 加 载 时 ， 加 载 所 有 交易 对 价格 信息 。 
数据 接口 

。 接 口 地 址 : /apivprice/vdquery 

。 请 求 参数 

下 
。 提交 方式 : get 
。 啊 应 结果 : 


{ 


"reSuJ]t'": Ce 

"data": [ 
站 OO 
「 ] 


推送 交易 对 实时 价格 
实时 推送 变化 交易 对 的 币 价 、 涨 跌幅 、 成 交 量 等 信息 。 
触发 条 件 当 市 场 有 新 成 交 订 单 时 ， 和 触发 变化 交易 对 价格 推 


数据 接口 

。 接 口 地 址 (TOPIC) price.update 
。 请 求 参 数 无 

。 响应 结果 : 


{ 
"method"”: "price.Uupdate'"， 
iolctecie sa 
// 交 易 对 id、 价 格 、 涨 幅 百 分 比 、 成 区 量 (24H)、 高 | 
[1，0.0049，-0.0585，4371833.4722，0.00: 
由 ] 
] 
j 
技术 实现 


1. 碍 询 每 一 个 交易 对 最 后 一 个 成 交 订 单 的 价格 
2. 在 同步 区 块 及 报表 数据 后 ， 增 量 推送 该 交易 对 的 实时 价格 
全 前 病 


通过 本 小 节 的 学 习 、 思 考 与 动手 实践 ， 我 们 完成 了 对 外 交易 对 
实时 币 价 的 接口 查询 以 及 socket 数 据 推送 。 


在 教程 中 如 出 现 销 旋 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackHook 
驴 偶 才 四 码 加 违 稚 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 


changelog 
2019-03-04 zhangliang \zhangliang@Qcldy.orgh' 


。 亡 次 发 入 
2019-03-05 zhangliang 


。 数据 接口 完善 


第 3 章 集成 UI 腹 面 


8.1 章节 人 简 述 


8.2 对 搂 后 闪 服 务 接口 


第 9 章 项 目 部 署 气 上 线 


9.1 章节 人 简 述 


本 章节 主要 介绍 在 项 目的 开发 与 测试 阶段 完成 后 ， 如 何 部 署 到 
正式 环境 ? 而 在 这 个 过 程 中 ， 我 们 将 分 为 五 个 步骤 进行 配置 处 
理 
。 上 线 数据 准备 
其 中 ， 包 括 mysdl 库 数据 脚本 、 初 始 化 表 数 据 、 多 个 EOS 帐 
号 〈 分 离 权 限 ) 、 合 约 初 始 化 脚本 等 
服务 吉 组 件 安 闭 与 配置 
主要 负责 对 mysdqdl、nginx、docker、node 等 组 件 的 安装 与 
配置 
合约 发 布 与 权限 配置 
主要 包括 : 合约 发 布 、 初 始 化 数据 、 针 对 多 个 EOS 帐 号 进 
行 分 级 授权 
后 端 服务 配 置 与 启动 
主要 包括 : 针对 线 上 环境 参数 及 正式 链 世 点 配置 进行 后 端 
服务 能 数 配 置 以 及 守护 线程 配置 
。 前 端 服务 配置 与 局 动 

主要 包括 : 前 端 接口 参数 配置 以 及 守护 线程 配置 


通过 整个 章节 的 学 习 及 动手 实践 ， 你 将 可 以 了 解 到 如 何 合理 化 
配置 你 的 服务 人 器 、 中 间 件 及 数据 库 ， 掌 握 整 个 智能 合约 的 完整 
发 布 流程 以 及 数据 维护 等 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackiHook 和 
马 和 筷 才 四 三 加 速 鉴 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 


changelog 
2019-03-12 zhangliang(mallto:zhangllang@cldy.org) 


。 亡 次 发 祝 


9.2 上 线 数据 准备 
上 线 数据 准备 


本 小 节 将 主要 介绍 正式 部 署 项 目 时 该 准备 哪些 必要 数据 。 比 
如 : 数据 库 表 结构 脚本 、 初 始 化 表 数 据 、 所 要 授权 的 EOS 帐 号 
以 及 合约 数据 等 。 


智能 合约 
1) 帐号 及 私 钥 


1. 顶级 帐号 说 明 ; 该 帐号 主要 用 发 布 侣 约 ， 即 合约 拥有 人 。 
另外 ， 会 用 此 帐号 设置 其 他 帐号 权限 。 

2. 目 动 交 易 帐 号 说 明 : 该 帐号 主要 用 于 负责 调度 合约 中 的 搓 
合 方法 时 进行 签名 操作 。 注 : 此 帐号 只 需 提 供 对 
应 私 钥 地 址 即 可 ， 不 需要 注册 eos 帐 号 。 

3. 系统 运 萌 帐号 说 明 : 该 帐号 主要 用 于 维护 合约 基础 数据 。 
包括 : token/ 交 易 对 /手续 费 等 。 

4. 交易 手续 帐号 说 明 : 该 帐号 主要 接收 交易 手续 费 


2) 合约 编译 文件 


e XXX.abi 
e。 XXX,.Wasm 


3) 链 操作 脚本 


1. eosio.code 授 权 
2. 创建 权限 组 

3. 权限 组 方法 映射 
4. 发 布 合约 


5. 初始 化 合约 
6. 创建 钱包 并 导入 私 钥 


后 端 服务 


1) 数据 库 (mysql) 

数据 库 用 户 名 : username 数据 库 密 码 : XXXXXx 数据 库 端 口 : 
3306 数据 库 地 址 : localhost 

2) 数据 库 脚 本 

注 : 创建 数据 库 及 表 结 构 以 及 初始 化 基础 数据 表 。 


人 小结 


通过 本 小 和 的 学 习 、 思 考 与 动手 实践 ， 我 们 完成 了 正式 上 线 
之 前 所 需 文件 的 各 项 准备 工作 。 


在 教程 中 如 出 现 销 旋 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackHook 
纺 | 人 才 四 码 加 违 蕉 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 


changelog 2019-03-05 zhangliang 
。 急 次 发 称 


9.3 服务 器 组 件 配置 与 安 效 
(MysdqlIINginxIPM2) 


本 小 节 将 主要 介绍 如 何 配置 项 目 所 依赖 的 各 项 服务 组 件 。 比 
如 : 如 何 通过 反 辐 代理 web 服 务 、myqsl 安 装 与 权限 配置 。 


本 次 我 们 所 使 用 的 服务 怖 为 阿里 云 ECS 服 务 避 实 例 ， 操 作 系 统 
为 Ubuntu 16.04.5 LTS 。 


一 、 数 据 库 Mysqll 


数据 库 作 为 项 目的 基础 服务 组 件 ， 主 要 用 于 存储 链 上 成 区 订单 
数据 以 及 不 同 维度 的 报 示 数据， 以 此 作为 链 和 页 面 的 数据 缓存 
服务 。 一 方面 可 以 提高 用 户 使 用 体 煌 ， 一 方面 提供 中 间 缓 存 服 
当 链 上 数据 不 可 用 或 时 效 较 慢 时 ， 能 够 剑 证 服务 的 可 用 


1. 安装 软体 


sudo apt Update 


sudo apt InstalLlL mysq]l-server 


2. 配置 服务 权限 
此 命令 主要 用 于 配置 数据 库 一 些 安 全 事项 。 比 如 设置 关闭 对 外 
访问 权限 ， 更 改 密码 策略 等 


mysq]l_secure_installLation 


3. 创建 数据 库 


CREATE DATABASE IF NOT_ EXISTS < 数据 库 名 > defau1lt ch 


4. 创建 数据 库 帐 户 


CREATE USER '< 帐 户 >'@'1localhost' IDENTIFIED BY '< 密 


5. 设置 帐户 权限 


GRANT _ ALL ON < 数据 库 >.* TO '< 帐 户 >'Q@'1ocalhost' WITI 
FLUSH PRIVILEGES 


show grants for '< 帐 户 >'@'%' ， 


6. 测试 

> mysql -uU < 帐户 > -h Localhost -p 
> Show databases 

二 、Nginx 


Nginx 作 为 系统 中 必 不 可 少 的 一 个 组 件 。 在 实际 应 用 场景 中 ， 
主要 利用 nginx 的 反 回 代理 及 负载 均衡 来 剑 证 整体 项 目 服务 的 
可 用 性 


1. 安装 


> Sudo apt update 
> Sudo apt Install1 nginx 


服务 安装 后 之 后 ，nginx 安 装 目录 如 下 : 


导 才 用 


-一 default.conf 
全 SSECOIEPaAFESms 


全 二 昌 oa 


一 koi-win 


上 一 mime .types 


| 一 modules 


全 是 ee 


-> /usr/ibvnginx/vmnoduJles 
on 上 


一 scgi_params 


1 


arams 


-一 win-utf 
后 续 配 置 我 们 将 会 在 conf.d 目 录 下 进行 文件 修改 。 
2. 检查 nginx 服 务 状态 


> SYStemctJ] 

e nginx,.Ser 
Loaded : 
ActiIve : 
Docs : 
Maln PID : 
TaSkKks : 
CGroup : 


如 上 疼 所 未 ， 
成 功 。 


Status ngIinx 
vice - A high performance web Server an 
Loaded (/Lib/vsystemd/system/XngiLInx.Servi 
actilive (running) Since Frl 2018-04-20 1 
man:nginx(8) 
2369 (nginx ) 
2 本 (全 可 mntdl5Sy) 
/System,.SLice/vnginx.Service 

广 2369 nginx: master process /usr/sbin/ 
[一 2380 nginx: worker process 


如 果 Active 为 active 则 表明 nginx 已 经 安装 并 运行 


同样 ， 我 也 可 以 通过 浏 贞 天 访 问 , http://Locahost ， 检查 服 


务 是 否 可 用 。 


Welcome to nginXIi! 


If you see this page, the nginX Web server is SUCCessfully installed 
and working. Further configuration is required. 


For online documentation and Support please refer to nginx.org. 
commercial Support is available at nginx.com. 


Thank you DrUsing nginx. 


3. 服务 配置 


1. 配置 负载 均衡 为 了 保障 服务 的 可 用 性 ， 我 们 针对 接口 服务 
可 以 提供 两 人 台 以 上 服务 实例 ， 这 样 即 使 一 台 究 然 宕 机 ， 也 不 
会 影响 到 整个 应 用 的 运行 。 


编辑 /etclnginxjiconf.dldefault.conf 配 置 文件 ， 添 加 以 下 代 
三 : 


UpSstream myapl_ server 1{ 
Server 192.169.0.1:4381 weligdht=3; 
server 192.169.0.2:4381 weligdht=3; 
Server 192,.169.0.3:4381 weligdht=3; 


】} 
Server 
JISsten 80 ; 
Server_name aplI.dappgame . 工 0 ; 


Locatilion / 
proxy_pass http:/v/myaplI_ server ; 
proxy_set_header X-Real-IP $remote_addr， 


】} 
下 


upstream 中 的 多 机 server 其 实 是 在 不 同 服务 右上 部 署 的 同一 
程序 代码 ， 且 可 以 根据 每 个 机 器 的 性 能 设置 其 权重 以 提高 或 降 
低 命 中 率 。 

当 大 量 服务 请 求 访问 我 们 的 web 服 务 时 ， 首 先 会 访问 到 nginx 
服务 ， 然 后 根据 权重 配置 反 向 代理 到 不 同 服务 器 应 用 服务 上 ， 
从 而 达到 负载 均衡 的 目的 ， 也 提高 了 整体 系统 的 可 用 性 。 

2. 配置 web 服 务 

同样 nginx 本 里 也 一 个 web 服 务 右 ， 相 比 apache， 它 更 加 轻 量 
且 占 用 很 少 的 内 存 及 资源 。 


编辑 /etclnginxjiconf.dldefault.conf 配 置 文件 ， 添 加 以 下 代 
位 : 


Server 
Isten 80 ; 
server_name dappgame , 工 0 ; 
root /datavwww 


Locatilion / { 
IndexX Index,htmlL Index,php， 


区 


Location ~* \. (gif|ljpglpng)$ { 
explires 30d ; 


】} 


listen: 对 外 访问 端口 ; server_name: 对 外 访问 域名 地 址 ， 
通过 此 项 设置 可 以 达到 同一 台 服 务 右 多 个 web 程 序 复 用 同一 80 
端口 的 需求 。 如 以 下 示例 配置 : 


Server 1 
JIsten 80 ; 
server_name apl_ v1.dappgame .1I0:， 
root /datavwww_VvIL， 


Locatilion / { 
IndexX Index,htmlL Index,php ， 


Location ~* \. (gifljpglpng)$ { 
explires 30d ; 


1 

Server 二 
JIsten 80 ; 
server_name apl_ v2.dappgame,.1Io0:， 
root /datavwww_Vv2 


Locatilion / { 
IndexX Index,htmlL Index,php， 


】} 


Location ~* \. (gif|ljpglpng)$ { 
explires 30d ; 


通过 本 小 世 的 学 习 、 思 考 与 动手 实践 ， 我 们 完成 了 数据 库 
mysdl 的 安 闭 及 用 户 配 置 ， 以 及 数据 库 实 例 的 初始 化 工作 。 除 
此 之 外 ， 还 安装 了 nginx 系 统 服务 ， 并 在 此 基础 上 配置 了 web 
服务 及 负载 均衡 。 


在 教程 中 如 出 现 钳 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail: 
zhangliang@Qcldy.org 


筷 才 四 码 加 速 营 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 


changelog 
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。 初次 发 称 


9.4 权限 配置 与 合约 发 布 
合约 发 布 与 权 限 配置 


本 小 和 将 介绍 如 何 将 入 能 合约 发 布 至 线 上 正式 环境 以 及 为 了 保证 区 
易 所 的 货 金 及 业务 的 正常 安全 运行 ， 我 们 将 通过 权限 分 级 的 方式 隔 
离 在 程序 中 运行 的 私 钥 运 行 级 别 。 


在 开始 操作 之 前 ， 需要 我 们 提前 准备 四 个 帐号 : 合约 帐号 (管理 
员 )、 运 维 帐号 、 调 度 帐 号 。 

新 建 本 地 钱包 

因为 整个 权限 配置 的 过 程 ， 都 是 通过 命令 窗口 的 形式 进行 操作 的 ， 
所 以 为 了 操作 的 方便 ， 我 们 需要 创建 一 个 钱包 ， 并 导入 前 面 准 备 的 
三 个 帐 瑟 私 钥 。 


首先 ， 在 本 地 创建 钱包 ， 并 将 生成 的 钱包 密码 保存 至 对 应 的 文件 当 
中 ; 后续 解锁 钱 的 时 候 需 要 用 到 该 密码 ， 所 以 必须 区 善 保管 。 


注 : 市 面 上 99.99% 的 资金 丢失 其 实 都 是 对 于 私 钥 的 保管 不 当 所 导 
致 的 。 


cleos wajljlet create -n mypocket --to-console | tall -: 


然后 ， 导 入 私 钥 


cleos wallet import -n mypocket --private-key < 私 钥 > 


合约 发 布 


cleos set contract < 合约 名 > "< 合约 abiVywasm 文 件 存储 目录 >" 


示例 : 发 布 交 易 所 合约 hackdappexch 至 公 链 环境 。 


cleos Set contract hackdappexch "contracts/vdexchange/ 


注意 : 执行 发 布 命令 时 ， 需 要 解锁 钱包 。 


权限 配置 

为 了 保证 系统 的 正常 运行 及 合约 安全 ， 所 以 我 们 需要 对 合约 的 权限 
进行 分 级 隅 离 ， 即 将 合约 中 的 方法 按照 唤 金 、 基 础 数据 、 搓 合 业务 
分 别 映 射 给 管理 员 、 运 维 、 调 度 帐 号 。 


建立 权限 组 


cleos set account permission < 合约 名 称 > < 权限 组 > '{f"thre 


示例 : 为 合约 (hackdappexch) 创 建 一 个 名 为 auth.trade 的 权限 组 . 


cleos Set account permission hackdappexch auth,trade 


在 执行 命令 时 ， 需 要 注意 钱包 十 否 处 于 解锁 状态 。 
权限 方法 映射 


cleos set action permission < 合约 名 称 > < 合约 名 称 > < 合约 方 


示例 : 将 合约 (hackdappexch) 中 的 方法 (executetrade) 映 射 到 
auth.trade 权 限 组 中 。 


cleos set action permission hackdappexch hackdappexch 


授权 
将 合约 中 的 某 个 权限 组 授权 给 某 个 帐号 或 地 址 。 1) 授权 给 帐号 


cleos set account permission < 合约 名 称 > < 权限 组 > '{f"thre 


2) 授权 给 地 址 
cleos set account permission < 合约 名 称 > < 权限 组 > '{f"thre 
示例 : 将 交易 所 合约 中 的 搓 合 权限 组 授权 给 EOS 地 


址 EoS7H8xqsUyAwCPDYfQ5RQYSFKzxeXx5cuucMLAC6g31GuUQEG9hdKz 


O 


cleos set account permission hackdappexch auth,trade 


通过 本 人 小节 的 学 习 、 思 考 与 动手 实践 ， 我 们 悉 并 完成 了 合约 的 发 
布 、 权 限定 义 及 授权 的 整个 流程 与 操作 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 指 
上 FE!Name: zhangliang | WeChat: rushking2009 | Mail: 
zhangliang@cldy.org 


急 和 所 才 四 矶 加速 站 ~ 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 加 群 
咨询 。 


changelog 2019-03-06 zhangliang 
。 亡 次 发 入 


9.5 后 端 服务 配置 与 局 动 
本 小 节 将 介绍 如 何 部 署 本 项 目的 后 端 服务 ， 其 中 包括 : 对 项 目 
参数 的 配置 、 日 志 配置 及 守护 线程 的 配置 


克隆 项 目 


考虑 到 后 续 方 便 更 新 与 升级 ， 我 们 通过 gitrssh 克 隆 的 方式 将 项 
目 拉 取 到 服务 左上 


> glit gitQgithub .com:Xxxx.git 


然后 ， 编 译 打 包 后 再 部 署 到 对 应 中 间 件 目 孙 。 每 次 升级 事先 将 
原 有 的 目录 文件 打包 备份 并 进行 文件 归档 。 当 上 线 失 败 时 ， 可 
快速 回 滚 。 


参数 配置 


。 配 置 后 端 服务 端口 ， 尤 其 是 一 机 多 实例 的 情况 ， 防 止 端 口 
冲突 
。 配 置 数据 库 参 数 
。 配 置 公 链 万 点 配置 
o _ chainid 
o_http 
e 合约 名 称 
o 调度 公 钥 地 址 
。 配 置 调度 时 间 
置 日 志 


。 检查 日 六 级 别 ， 改 为 info 或 更 高 级 别 
。 修改 日 志 存 储 目 孙 
。 修改 日 志 切 割 规则 


局 动 并 和 守护 服务 线程 
在 系统 运行 期 难免 遇 到 服务 中 断 的 情况 ， 所 以 我 们 需要 一 个 守 
护 服务 保证 服务 在 中 断 时 可 以 重新 启动 。 在 这 里 ， 我 们 将 采 

用 pm2 程 序 来 守护 Node 后 端 服 务 。 


< pm2 1Ls 


27287 
27308 
27348 
27303 


0 
27309 
27292 


Use “pm2 show <tid/name> ”to get more detailIs about an app 


安装 pm2 组 件 

> npm Instal]l pm2 -dg 
# 或 者 

> Yarn global add pm2 


启动 服务 实例 


> pm2 start "npm run Start:prod”-n dexchange 


查看 当前 运行 实例 


> pm2 ]S 
| App name | id | version | mode | pid | status 
| serdice | | fork | 19834 | online 


馆 TREEGB 
| serpool | 3 1|1341.0.0 |fork | 19815 | online 


| 1 | | 1 = 六 一 1 有 


| WeDQLCE [国电 二 .局 .局 | IOTK | 5555 | OnLLne 
| webpool |11 14141900.0 | fork | 19853 | online 
[II 


通过 本 小 下 的 学 习 、 思 考 与 动手 实践 ， 我 们 完成 了 项 目 上 线 前 
数据 库 、 日 志文 件 的 参数 检查 与 配置 以 及 Node 服 务 的 注册 与 
局 动 。 


在 教程 中 如 出 现 销 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail 
zhangliang@Qcldy.org 


HackiHook 和 
驴 5 所 才 四 三 加 速 览 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 
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9.6 前 端 服 务 配置 与 局 动 
前 端 服 务 配 置 与 局 动 


本 人 小节 将 介绍 如 何 部 获 本 项 目的 前 瑞 服务 ， 其 中 包括 : 对 项 目 
参数 的 配置 、 服 务 注册 局 动 。 


区 隆 项 目 
考虑 到 后 续 方 便 更 新 与 逢 级， 我 们 通过 gitssh 克 隆 的 方式 将 项 
目 拉 取 到 服务 器 上 


> glit gitQgithub .com:Xxxx.git 

然后 ， 编 译 打 包 后 再 部 署 到 对 应 中 间 件 目录 。 每 次 升级 需要 事 
先 将 原 有 的 目录 文件 打包 备份 并 进行 文件 归档 ， 以 便于 上 线 
失败 时 ， 可 快速 回 滚 。 

参数 配置 

。 检 得 后 韦 服 务 API 配 置 

服务 启动 

前 痪 的 局 动 方式 与 后 端 不 一 样 ， 在 前 面 草 Ti\<\< 服 务 器 组 件 安 
装 与 配置 >> 中 曾经 介绍 过 nginx 中 可 以 部 署 web 服 务 ， 所 以 我 


们 只 需要 将 编译 好 后 的 文件 直接 复制 到 nginx 配 置 的 目录 中 即 
可 。 


注 ， 在 进行 前 端 页 面 升 级 时 ， 需 做 好 原 有 程序 的 备份 。 


通过 本 小 世 的 学 习 、 思 考 与 动手 实践 ， 我 们 玫 悉 并 完成 了 对 前 
端 工程 上 线 前 的 配置 检查 工作 以 及 上 线 流程 操作 。 


在 教程 中 如 出 现 销 旋 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackHook 
驴 偶 才 四 码 加 违 稚 一 去 中 心 交易 所 


注 : 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨 询 。 
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第 10 章 补充 文档 


10.1 编码 规范 


该 章节 主要 介绍 了 在 进行 合约 开发 时 ， 需 要 注意 的 一 些 关 于 帐 
户 名 称 、 合 约 名 、 方 法 及 结构 体 定 义 时 要 遵守 的 编程 规范 。 建 


立 并 培养 民 好 的 编程 习惯 ， 


以 及 防止 在 正式 环境 上 线 时 ， 导 致 


意外 问题 的 发 生 。 比 如 : 在 私 链 环境 中 是 可 以 随意 定义 EOS 帐 
户 名 称 的 ， 但 在 线 上 环境 只 允许 创建 长 度 为 12 的 帐户 名 。 


命名 规范 


EOS 帐 户 命名 


。 和 名 称 仅 允许 包含 .、a-z、1-5 三 种 类 型 的 字符 。 
即 : abcdefghijklmnopqrstuvwxyz12345， 
。 名 称 必 须 以 字母 开头 且 长 度 为 12 。 


合约 命名 规范 


类 型 


Structs 


Classes 


Methods 


Types 


Template 
Arguments 


命名 规范 

全 部 小 写 ， 单 词 之 前 下 划 线 连接 
可 超过 12 个 字符 。 

全 部 小 写 ， 单 词 之 前 下 划 线 连接 
可 超过 12 个 字符 。 

全 部 小 写 ， 单 词 之 前 下 划 线 连接 
可 超过 12 个 字符 。 


全 部 小 写 ， 单 词 之 前 下 划 线 连 搂 。 


允 峰 命令 


, 长 度 不 


, 长 度 不 


。 长 度 不 


类 型 命名 规范 


Macros 全 部 大 写 


代码 注释 


。 单行 注释 /Comments / 
。 多 行 注释 1/ Comment Block / 


代码 缩 进 
用 3 个 空格 代替 Tabs 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackiHook 和 
纺 全 才 四 码 加 速 帝 一 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 
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第 11 章 EOS 开 发 手册 


11.1 零 基 础 体验 EOS 入 门 合约 开发 


本 教程 主要 面向 初 阶 开发 人 员 ， 目 的 在 于 带领 大 家 以 最 简单 的 示例 合约 ， 通 过 简单 但 不 失 完整 
的 流程 ， 体 验 整 个 合约 的 编译 、 发 布 与 调用 过 程 ， 从 而 让 大 家 从 直观 角度 有 个 清晰 的 概念 认 


一 、 帐 户 注 册 


1. 生成 公私 钥 地址 


在 进行 帐户 注册 时 ， 需 要 事先 提供 一 对 公私 钥 地 址 ， 以 便 在 注册 帐号 时 进行 绑 定 使 用 。 可 通 
EOS Key Generation 网 站 进行 公私 钥 地 址 生成 。 


EOS Key Generation 


This will generate a private and public key pair forthe EOS chain. The code is not mine. Itis forked from the code the EOS team built. The difference is 
that this works in any browser without the web3 dependency. It will work in any browser and you don't need any plugins. lve also removed everything 
else except the key generation bits. 


Source code can be reviewed here: https:/github.com/Nadejde/eos-token-sale. 


Ifyoufound this helpful please consider making a small donation 
ETH: 0x0bbe518debf97fb2e27d955b050cbd1e8ca90264 
EOS: g8qztenjzgege 


EOS public key 。” Generate EOS key 


EOS Key Generation 


This will generate a private and public key pair forthe EOS chain. The code is not mine. ltis forked from the code the EOS team built. The difference is 
that this works in any browser without the web3 dependency. It will work in any browser and you don't need any plugins. lve also removed everything 
else exCcept the key generation bits. 


Source code can be reviewed here: https://github.com/Nadejde/eos-token-sale. 


Ifyoufound this helpful please consider making a small donation 
ETH: 0x0bbe518debf97fb2e27d955b050cbd1e8ca90264 
EOS: g8qztenjzgege 


EOS public key 


Register EOS key 


Please back up the private key displayed below in multiple safe locations before continuing. You should make more than one copy and keep all copies in 
separate Secure locations. If you Use an external storage device Such as a USB stick, make sure to safely eject the device before continuin8g. 


Description EOS Token Sale Claim Key 
Public key BEBOS7crh76snd4x58gUGDJwHJM9YgPSXRKCVPgwVSPKBWt39FtRERC 


Private key 5K9U12zvU4TJZLVr2Wvs9BGELu2kibDe77hkhJX24jiLjH2dtc8b 


There is no wayto recover your private key. You must save it right now or you will be unable to access your EOS tokens when the sale ends. 


2. 帐号 注册 


通过 Jungle2.0 - EOS Test Network Monitor (CryptoLions.io) 网 站 进行 EOS 帐 户 的 创建 
笋 EOS Jungle2.0 Testnet Monitor (GitHub) 
470 |1TPS Live/Alltime high: 15 /9179 | APS Live/All time high: 10/9179 | Connected Users: 57 | Home 
Register 医生 作 SS 性 站 | 钨 的 endpoints | ni Downtime | Block Explorer 


Total 45954385 Transactions in 10225235 Blocks / 20300809 Blocks 


7 2 O O 809 20300809 eosio.token::transfer sicborobot12 Sicborobot12>batbaccarat1 0.0100 EOS 
in 


20300809 batbaccarat1::activebet batbaccarat1 《"game_id":151743"user_bet_info" 


reversible: 20 300 484 [325] {"user"':"sicborobot12%"betamount':"0.0100 
EOS""bet_infos": 
注册 EOS 帐 号 ff"type"1"bet amount":"0.0100 EOS9] 办 


ZU19-03-26 14:16:25 
20300808 batbaccarat1::activebet batbaccarat1 {"game_id":151743,"user_bet_info" 
{"user'"sicborobot15""bet_amount":"0.0100 


EOS'"bet_infos“ 


Produced by: eoscafeloons [typer:1wbet_amounte:"0.0100 EOS9] 


十 图 中 标 红 create account, 在 弹出 界面 中 ， 填 写 事 先生 成 的 公 钥 地 址 


Create account 


蕊 忆 


MY 


Account name liontesterI2 ”填写 EOS 帐 户 名 称 
(a-z,1-5 are allowed only. Length 12) 


Owner Public Key EOS6MRyAjQq8 公 钥 地 址 =hVPJqcVpscN5So8BhtHuGYqET5GDV 


Active Public Key EOS6MRyAjQq8 公 铀 地 址 z2VPJqcVpscN5So8BhtHuGYqET5GDV 


| 进行 人 机 身份 验证 心 
reCAPTCHA 
隐私 权 - 使 用 条 喜 
Create account 闪 
Account name hackdappcom5 


(a-z,1-5 are allowed only. Length 12) 


Owner Public Key EOS6NcaFvvoekuBjhZLsBVywiMcN7VTVmgvAdA5srgTvQMeDmd 


Active Public Key EOS6NcaFvvoekuBjhZLsBVywiMcN7VTVmgvAdA5srgTvQMeDmd 


\wA 进行 人 机 身份 验证 心 
reCAPTCHA 
隐私 权 - 使 用 条 数 


见 上 图 中 ， 


需要 填写 三 个 信息 ， 其 中 account name 主 要 用 于 填写 我 们 易于 记忆 的 帐户 名 称 ， 但 其 帐户 名 
称 长 度 只 允许 12 位 长 度 ， 且 其 组 成 字符 也 只 能 从 a-z, 1-5 以 及 一 个 点 符号 组 成 。 至 于 owner 
public key 和 active public key 分 别 对 应 该 帐户 owner 权 限 和 active 权 限 。 如 果 从 安全 角度 讲 ， 


两 个 权限 所 对 应 的 公 钥 地 址 应 该 设置 成 不 一 样 的 ， 这 样 当 active private key 技 失 的 时 候 ， 可 以 
使 用 ower 权 限 对 active 权 限 对 应 的 公 钥 地 址 进行 更 换 。 因 为 ower 和 active 权 限 是 有 层次 关系 
的 ， 只 允许 低级 权限 对 下 次 权限 进行 操作 。 在 不 丢失 ower 私 钥 的 情况 下 ， 也 可 以 实现 对 ower 
权限 地 址 的 更 换 操作 。 


点 击 create, 创建 成 功 后 ， 会 显示 如 下 信息 


executed transaction: 5a6411c2bbc6e94c7bb090ca768bf79c96e5c2ac176ab1be709be95504a3dd6b 
336 bytes 1135 us warn 2019-03-26T06:32:35.989 thread-0 main.cpp:482 print_result ] warning: 
transaction executed locally but may not be confirmed by the network yet 


ffrom'": junglefaucetsstowweosiorams*quantity'。 "0.0879 EOS""memo":"buy ram 人 jg 二 
eosiotoken::transfer ffrom'":"junglefaucet' "to":"eosio.ram""quantity":"0.0879 EOS "memo'":"buy ram'"} 划 
eosio.ram <= eosio.token'::transferf"from":"junglefaucet" "to""eosio.ram""quantity":"0.0879 
EOS""memo""buy ram 少 # eosio.token <= eosiotoken::transfer 

ffrom":"junglefaucet" "to""eosio.ramfee""quantity":"0.0005 EOS""memo'"ram fee}#junglefaucet <= 
eosiotoken::transfer ffrom":"junglefaucet" "to":"eosio.ramfee""quantity":"0.0005 EOSmemo'"ram 
fee 中 # eosio.ramfee <= eosio.token::transfer 


、 申 领 EOS 


在 Jungle2.0 - EOS Test Network Monitor (CryptoLions.io) 页 面 ， 点 击 菜单 栏 中 的 Faucet 按 
钮 ， 会 弹出 如 下 界面 


liontester12 ”填写 帐号 名 称 


5 


””- 
领取 100EOS 
” 


三 、 查 看 帐户 明细 (余额 1/RAM / CPU / NET 资 源 ) 


在 Jungle2.0 - EOS Test Network Monitor (CryptoLions.io) 页 面 ， 点 击 荣 单 栏 中 的 account 
info 按 钮 ， 弹 出 如 下 界面 : 


[esosanrmennuvmrvsoeamcaoocsoapeouca | 

上 eleoeornnn onnionne eroerorence secnae 和 填写 帐号 名 
称 后 ， 点 击 get 按 钮 , 便 可 以 查 到 该 用 户 的 EOS 余 额 及 公 钥 地 址 信息 。 

四 、 编 译 合约 

本 步骤 将 使 用 EOS 所 提供 的 cdt 开 发 工具 包 完 成 对 简单 示例 合约 的 编译 工作 。 

1) 在 本 地 安装 eosio-cpp 工 具 命令 


brew tap eosio/eosio.cdt // 增 加 仓库 
brew instal1l eosio.cdt ， // 安 装 工具 包 


> eosio-cpp --help 


注 : 可 使 用 eosin-cpp --help 命 令 来 查看 所 有 参数 说 明 


OVERVIEW: eosio-cpp (Eosio C++ -> WebAssemb1ly compiler) 
USAGE: eosio-cpp [options] <input file> 


OPTIONS : 


Generic 0ptions : 


-help - Display 
-heJlp-1IiSst - Display 
-VerSlion - Display 


CompIiler options : 


-C - Include 
-CC - Include 


2) 编写 简单 示例 合约 (helloworld.cpp) 
#Include <eoSliolib/eosio.hpp> 


USsing namespace eoSsio 


avai]lab]le options (-help-hidden for mor 
List of available options (-help-List-h 
the version of this program 


comments in preprocessed output 
comments from within macros in preproce 


class 司 中 eosaoseconteeaca 川 呈 nenaio 生 :站 pubancEconmernacteest 


pub]ic : 
USing contract: :contract 


[[Leosio::action]j] 
void hi( name User ) 
风 且 世 全 和 二 南 < 币 于 
】; 


EOSIO_DISPATCH(hel1lo，(hi) ) 


3) 进行 合约 编译 ， 生 成 abi 合 约 描 述 文件 及 wasm 合 约 文件 


eosio-cpp -abigen "contracts/he1llo,cpp'” -oo "contracts/he11o,.wasm' --contract 


编译 完成 后 ， 会 生成 hello.abi、hello.wasm 两 个 文件 。 


五 、 购 买 RAM、CPU 、NET 资 源 


1. 安装 scatter 
在 chrome 浏 览 器 中 安装 Chrome 网 上 应 用 店 - scatter 揪 件 。 


注 : 如 果 Chrome 揪 件 商 店 无 法 打开 ， 则 可 以 使 用 Start | Chrome Extension Downloader 进 行 下 
载 。 


， ， 点 击 浏览 器 scatter 揪 件 ， 它 会 先 让 你 进行 密码 设置 等 操作 。 帐 户 密码 设置 好 后 ， 
ij 进入 屠 : 


首先 ， 导 入 私 钥 地 址 。 可 根据 下 图 进行 操作 ; 


[ee | 


导 闪 私 钥 


然后 ， 将 私 钥 与 具体 的 区 块 链 节点 进行 绑 定 操作 


2. 绑 定 scatter 帐 号 
访问 内 存 交 易 - 钱包 - EOSX - Fastest EOS Block Explorer 网 站 ， 绑 定 scatter 帐 号 


3. 购买 资源 
购买 RAM 


购买 CPU 与 NET 资 源 


用 于 计算 资源 的 抵押 数 领 (以 EOS 为 单位 ) 
0 购买 CPU 资源 


用 于 网 络 资源 的 抵押 数额 〈 以 EOS 为 单位 ) 
02 购买 NET 资 源 


抵押 


六 、 发 布 合约 
如 果 你 没有 事先 购买 RAM 资 源 ， 可 以 会 提示 以 下 错误 信息 


"code": 500， 


"message": "Internal Service Error'"， 
“Error : 寺 
"code": 3080001， 
"name": "ram_usage_exceeded'"， 
"what": "Account using more than allotted RAM Usage"， 
"details": [ 
二 
"message": "account hackdappcom1l has insufficient ram; needs 26318 b 
"file": "resource_1limits.cpp"， 
"1ine_number": 213， 
"method": "verify_account_ram_usage" 


为 了 方便 大 家 的 操作 ， 特 提供 了 一 个 发 布 合约 的 示例 工程 


口 hackdapp / learn_eos @Unwatch~ 1 广 Star 0 YYVFork 0 
《> Code lssues 0 Pull requests 0 Projects 0 Wiki Insights Settings 
快速 体验 EOS 入 门 合约 Edit 


e0S Contract nodejs “ Manage topics 


名 2 commits P1branch S 0 releases 时 1contributor 
全 
Branch: master ~ New pull request Create newf 和 e Uploadflles Find File 
3 hackdapp init proj Latest commit 9377bb5 a minute ago 
国 contracts init proj aminute ago 
三 utils init proj aminute ago 
卓 README.md Initial commit 2 hours ago 
习 index.js init proj aminute ago 
四 package-lock.json init proj aminute ago 
目 package.json init proj aminute ago 


1) 克隆 示例 工程 : 


git clone gitQ@github,com:hackdapp/Jlearn_eos ,gfit 


将 之 前 编写 的 示例 合约 ， 放 在 工程 目录 contracts 下 
2) 编辑 配置 文件 deployjs 和 package.json 


//flle: deploy.js 

const eos = require(',./Vutils/eossdk' )(({ 
chainId: "e70aaab8997e1dfce58fbfac8ocbbb8fecec7pb99cf982a9444273cbc64c41473 
httpEndpoint: "http:/V/Jjungle2,cryptolions,io:80"， 
keyProvider: "5JxdqGao9rzXxWwBUDnNZzALyxaFdmZYXiZ46EZHL4SJkHKkryzCFKxu"，V// 可 改 ; 
authorization: 'hackdappcom1l@active',// 可 以 改 为 自己 的 eos 帐 户 
broadcast: true， 
Slgn: true 


更 


const {deployContract} = reduire('`./utils/Xdeploy ' ) 


depJoyContract(eos，({ account: "hackdappcom1"，contractDir: ",/Vcontracts"” 上 ) 
console,1og( Deployment Successfu1 ，JSON.stringify(result，nul1 ，4)) 
赐 


,Catch(err => { 
console,error( DepJloyment faliled ，err) 


) 


同时 ， 还 需要 再 编辑 package.json 


/V/package,json 


{ 
"name": "learn_eos"， 
ovVeIecsaiOomeaielOR 9 
"description'": "快速 体验 EOS 入 门 合约 "， 
| = 人生 险 冯 全 
SGIoD 上 二 Se 
SECNONNEKEROCSNGOESSESSDECO TEL REXTEET 
"build": "eoslio-cpp -abigen "contracts/hel1lo.cpp” -0 'contracts/Vhel]lo,wa 
eploweee node ndex Ts 
外 
epOsTEOIYS 全 
VIDEO ODS 
"Url1": "git+https://github .com/hackdapp/Jlearn_eos ,gjit"” 
拟 
全 加 下 仙剑 
全 放 SS SC 
人 
"Url": "https://github ,com/hackdapp/Jlearn_eoSs/issues'" 
外 
"homepage": "https:V/github .com/hackdapp/learn_eos#readme"， 
JeBDendehces 
egOsiiswe 人 下 69 以 9 
} 


3) 合约 发 布 


npm run dep]loy 


显示 Deployment successful, 则 表示 发 布 合约 成 功 。 


七 、 测 试 合 约 及 合约 方法 调用 
编写 测试 文件 index,js 


const eos = require('./Vutils/eossdk')({ 
chainId: "e70aaab8997e1dfce58fbfac8ocbbb8fecec7b99cf982a9444273cbc64c41473 
httpEndpoint: "http:/V/Jjungle2,.cryptolions,io:80"， 
keyProvider: "5JxdqGao9rzXxwBUDnNZALyXxaFdmZYXiZ46EZHL4SJKkHKryZzCFKXu"， 
authorization: "hackdappcom1@active '， 


broadcast : 
Slgn: true 


现 


const data = 
actions : 


true， 


上 


account : "hackdappcom1 '， 


name ， 


， IE 


authorization: [{ 


天 


actor: "hackdappcom1 '， 
permission: "active 


data ls user sa 


】} 


eos transaction(data),.then((result)=>1{ 


console,1og(JSoN,Sstringify(result,.processed,action_traces[0],.consoJe，nu 
}).catch((err )=>{ 
conSsole.1og(err ) 


二 


运行 调用 命令 


node index,js 


运行 结果 如 下 


ET 


通过 本 章 的 学 习 以 及 自我 动手 实践 ， 了 解 在 测试 网 上 如 何 进行 私 钥 生 成 以 及 帐号 注册 ， 学 会 如 
何 使 用 eosio-cpp 命 令 编译 示例 合约 以 及 通过 脚本 进行 合约 的 发 布 及 测试 的 完整 操作 流程 。 


测试 网 帐号 


帐户 名 

hackdappcom1 
hackdappcom2 
hackdappcom3 
hackdappcom4 
hackdappcom5 


参考 资料 


公 钥 
EOS6LTWfM5ffbmjUhvwFnrU5QEBrmkzsRo2eXxogr2h9oP8DUuzgAi 
EOS6dqCdbFLuYK5rGK9LDPzcboLdqy4phrUXxLXLrhLgXxVBpzLzsJke 
EOS57B3rxRBBUiITyZf9iBxsWyQnvEhdq2H95wbBbjdzcLbV1gfJ4zy 
EOS7i5Diz2uqXxSpvutmV4DftBRrL1XASzxsSdWBGrgzngPoxhT2dk 
EOS6NcaFvvoekuBjhZLsBVywiMcN7VTVmgvAdA5srgTvVQMeDmdiAH 


1. https:/nadejde.github.io/eos-token-sale/ 

2. http:/monitorjungletestnet.io/#home 

3. https:/ungle.eosx.io/tools/ram/buy?symbol=10 

4. https:/github.com/hackdapp/learn_eos 

5. https://chrome-extension- 
downloader.com/f944f5bf7bc58292048aa5b9bf29dc48/Scatter.CcrX.CrX.CrX 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 指正 ! Name: zhangliang | 
WecChat': rushking2009 | Mail: zhangliang@cldy.org 


11.2 EOS 知 能 合约 的 标准 化 开发 流程 


在 前 一 个 章节 中 ， 我 们 介绍 了 如 何在 本 地 快速 搭建 一 个 EOS 项 
目 工 程 以 及 如 何 快 速 使 用 vscode 构 建 一 个 EOS 本 地 链 环境 。 


那么 本 章 世 ， 将 会 介绍 如 何在 此 项 目 工程 结构 中 狐 建 一 个 业务 
合约 。 在 合约 开发 过 程 ， 如 何 进行 合约 设计 、 代 码 规范 以 及 
在 开发 中 需要 规避 的 安全 问题 。 关 于 安全 问题 ， 我 们 会 在 后 续 
的 一 个 章 下 中 集中 讲解 。 

除 此 之 外 ， 还 会 教 大 家 如 何 利用 现在 文档 资料 。 比 如 : 如 何 选 
择 合 适 的 数据 类 型 ， 合 约 中 系统 方法 如 何 使 用 ， C+ + 资料 查 


询 等 。 


接 下 来 ， 我 们 将 一 步 步 市 大 家 创建 目 己 的 智能 合约 


首先 ， 在 工程 目 孙 下 新 建 两 个 文件 dexchange .hpp 
和 dexcange .cpp.: 


上 一 CMakeLists ,txt 

上 一 README .md 

全 SUOIETEAD 攻 < 

| 一 dexchange 

一 dexchange,.cpp  // 头 文件 定义 
[一 dexchange,hpp  // 源 文件 定义 
| 一 docker 

人 

| 一 package.json 

es 


8 directorlies，21 files 


dexchange.hpp: 主要 用 于 定义 合约 主体 。 并 在 合约 中 ， 定 
义 所 有 交易 所 业务 方法 及 方法 内 部 需要 使 用 的 业务 模型 。 


dexcange.cpp: 主要 针对 dexchange.hpp 定 义 的 接口 进行 业 
务 扩 展 实现 。 


然后 ， 在 dexchange.hpp 文 件 中 定义 合约 主体 内 容 ， 分 为 编 
写 六 小 段 内 容 


1. 命令 空间 ， 主 要 用 于 处 理 相同 类 或 数据 类 型 冲突 的 问题 。 
比如 : 在 A 包 中 有 一 个 数据 类 型 person; 在 B 包 下 也 同样 有 
一 个 数据 类 型 person; 在 这 种 情况 下 我 们 想 要 使 用 不 同 的 
person 数 据 类 型 ， 只 能 通过 添加 命名 空间 来 进行 区 分 


namespace chaindesk { 


2. 合约 类 定义 
class [[eosio::contract( "dexchange"”)]] dexchandg 


3. 构造 男 数 定义 


dexchange( name receliver，name code，datastream- 


构造 国 数 必 须 定义 ， 该 函数 主要 用 于 初始 ws 
变量 receiver、code、ds, 以 供 合 约 实现 中 通过 _self， code 


调用 
4. 类 函数 定义 


[Leosio::actionj]|j 
WE 
eosio::action 标 识 当 前 方法 可 对 外 访问 。 
5. 数据 结构 体 定 义 
Struct balance 1 


asSset total_asset ， 
asset frozen_asset ， 


UInt64 t priImary_ key()const 并 
return total_asset .Symbol,raw( ) ; 


】} 


// 序 列 化 结构 体 
EOSLIB_SERIALIZE(balance， (total_ asset)(fro: 


和 


6. 访问 索引 器 


typedef eoslo::multli Index<"balance"”n，balance: 


该 索引 右 为 访问 业务 数据 的 入 口 ， 文 持 按 主键 及 目 定 义 索 
引进 行 数据 查询 。 
另外 ， 在 定义 过 程 中 ， 可 根据 实际 业务 需求 目 由 设 定 成 员 
量 与 成 员 函 数 的 访问 级 别 ， 是 对 外 可 见 (public) 还 是 对 外 
不 可 见 (private)。 


其 次 ， 在 dexcange.cpp 文 件 具 体 实 现在 头 文 
件 dexchange.hpp 中 定义 的 国 数 方法 。 在 合约 方法 实现 文 


件 ， 主 要 编写 以 下 三 部 分 内 容 : 


1. 


2. 
忆 


AAA 人 en 
命令 空间 


在 多 个 命令 空间 的 情况 下 ， 用 于 区 分 相同 方法 。 

实现 具体 方法 

apply 宏 定义 

用 于 控制 智能 合约 方法 调用 前 的 逻辑 判断 以 及 路 由 转发 。 

比如 : 充值 EOS 币 的 时 候 ， 可 以 判断 是 否 是 从 eosio.token 
发 送 过 来 的 消息 通知 。 

除 此 之 外 ， 如 果 在 此 安定 义 中 未 配置 合约 方法 ， 外 部 是 无 
法 进行 调用 的 。 


namespace chaindesk 1{ 


void dexchange: :Init(){ 


extern "”C"…” void applLy(uint64 tt receiver，UILnt6 


if ((code == "eosio.token”n.value) && (ac 
transfer data = eoSslio::unpack_action_ d 
If(data.to,.value == recelver && 
code == "eoslo.token"”n.value && 1d 
儿 
eoSlo: :execute_action(eosio: :name( 
】} 
return ， 


】} 


If (code != recelver ) 


return， 


Switch (action) 1 
EOSIO_DISPATCH_HELPER(dexchange， (Init 
了 了; 


eoSlIo_exit(0) ; 


】} 


下 一 步 ， 党 试 编译 与 发 布 合约 可 通过 上 一 章节 工程 配置 介绍 

发 布 合约 的 方式 ， 进 行 合 约 编译 及 发 布 ; 

最 后 ， 合 约 测 试 与 调用 。 关于 合约 的 测试 ， 有 两 种 方式 : 

。 使 用 cleos push action 的 方式 直接 调用 合约 方法 测试 

。 使 用 jest 插 件 编译 js 脚本 进行 测试 鉴于 目前 只 针对 合约 本 续 
进行 开发 ， 上 暂时 先 使 用 cleos 命 令 的 方式 进行 测试 。 

# 工 ， 解 锁 钱 包 

cleos wallet un1lock -n < 钱包 名 称 > --password < 钱包 蜜 : 

# 2. 调用 方法 

cleos push action < 合约 名 > < 合约 方法 > [< 参数 1>，< 参 数 2 


知识 操 


1. 头 文件 (.hpp): 用 于 声明 类 定义 ， 其 中 包括 成 员 变 量 、 数 据 
结构 体 、 成 员 函 数 的 定义 ， 但 对 于 成 员 函 数 在 此 文件 中 并 
不 进行 具体 实现 。 

2. 源 文件 (.cpp): 主要 用 于 对 头 文件 中 已 声明 的 成 员 函 数 进 行 
具体 实现 。 

3. .hpp 和 .cpp 文 件 实际 上 是 可 以 统一 整合 成 .cpp 文 件 中 的 。 但 
为 了 遵循 规范 ， 以 及 在 与 第 三 方 进 行 系统 集成 时 不 暴露 自 


己 的 核心 实现 而 又 能 让 对 方 调用 ， 所 以 需要 采用 封 逆 隔离 
拘 方 吉 。 


参考 资料 
1. 在 线 编辑 矿 : 


https://www.tutorlalspolnt.com/complle_cpp_online.php 
2. C++ 参考 手册 :，http:/www.cplusplus.comrn/ 
3. The cplusplus.com tutorial: 
http:/people.scs.carleton.ca/~dehne/projects/cpp- 
doc/tutorlalMindex.html 


11.3 使 用 EOS.js 发 布 EOS 智 能 合约 
使 用 EOS.js 发 布 EOS 知 能 合约 


在 之 前 的 EOS 合 约 开发 文章 ， 你 可 能 学 会 了 如 何 通过 EOS 系 
统 命令 cleos set contract 的 方式 进行 智能 合约 的 发 布 与 升 

级 。 

但 在 开发 过 程 中 ， 可 能 有 的 同学 持续 在 命令 容 髓 与 开发 IDE 间 
频 党 切换 ， 对 开发 效率 有 一 定 程 序 的 影响 ， 那 是 否 有 一 种 更 好 
的 方式 帮助 我 们 在 一 个 窗口 里 快速 发 布 合约 呢 ? 


那么 本 文 将 带 你 了 解 如 何 通 过 EOS.js 进 行 智能 合约 的 发 布 。 


Transactions 


如 上 图 所 示 ， 在 进行 合约 发 布 时 ， 需 要 用 到 eos 系 统合 约 中 的 
两 个 方法 : setcode、setabi。 而 这 两 个 方法 分 别 会 用 到 智能 
合约 编译 后 的 两 个 文件 : *.wasm、*.abi。 


注意 : 本文 示 例 中 使 用 的 eosjs 的 版 本 为 16.0.9 。 


首先 ， 需 要 初始 化 EOS-SDK 实 例 。 事先 准备 好 初始 化 SDK 所 
必需 的 参数 


e。 Chalnid 
所 要 发 布 的 目标 EOS 链 chainid. 例如 : 正式 chainid: 
aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a1L19ffpbe 
aef943642f0e906; jungle 汕 试 网 chainid: 
e70aaab8997e1dfce58fbfac80Ocbbb8fecec7b99cf982a944 
4273cbc64c41473 等 等 


。httpEndpoint 
EOS 链 环境 http 接 口 地 址 。 例如 : http:Wlocalhost:8888 
。 keyProvider 


合约 帐户 私 铀 ， 主 要 用 于 交易 签名 。 


/V/conf1ig ,js 
const Eos = requlire( 'eosjs -) 


const eos = EoS({ 
chainId: "cfo57bbfb72640471fd910bcb67639c22df9 
httpEndpoint: "http:// Localhost :8888 ， 
keyProvider: "5K7mtrinTFrvVTduSxIzUc5hjXJEtTJVT 
broadcast : true， 
SIgn: true 


呵 


module.exports = { 
eOsS， 


了 


/https:/V/gist.github.com/hackdapp/2522411b98b1acd 


下 二 步 ， 策 要 代码 实现 对 合约 文件 下 的 wesm 及 .ab 文件 的 
读 取 ; 


function getDepLoyapleFilesFromDir(dir) 世 
const dirCcont = fs.readdirSync(dir ) 
const wasmF1iIJeName = dirCcont ,find(fiJlePath => 
const ab1lIFiIJeName = dirCcont ,find(filePath => 千 
If (!wasmFILIeName) throw new Error( Cannot fin 
if (!abiFileName) throw new Error( Cannot find 
return 1{ 


wasmPath: path. join(dir，wasmF1IJLeName )， 
abiPath: path,.join(dir，abiF1IleName)， 


1 
/https://gist.github.com/69b29103e5cc114f44783900 
然后 ， 通 过 调用 eos 实 例 ， 分 别 执行 系统 合约 的 Setcode/setabi 
方法 ， 从 而 达到 智能 合约 的 发 布 ; 


function depJoyCcontract({ account，contractDIr 】) 
const { wasmPath，abiPath } = getDepJoyab1eFIJ]es 


const wasm = fs.readFileSync(wasmPath ) 
const abl = fs.readFileSync(abiPath ) 


const codePromilise = eos.Ssetcode(account，0，0，Ww 


const abliPromise = eos.Ssetab1lI(account，JSON.pars 
return Promise,all(LcodePromise，abiPromise]) 


/https://gist.github.com/69b29103e5cc114f44783900 


最 后 ， 调 用 deployContract 方 法 ， 测 试 合约 发 布 功能 。 


depJoyContract({ account : "eoslio.token"，contractD 
console,1og( DepJoyment SuccessfulL ，JSON,Sstri 
,Catch(err => 1{ 
console,error( DepJovment falled ，err ) 


) 


//Lhttps:/V/gist.github.com/69b29103e5cc114f44783900 


小 结 

通过 本 文 我 们 学 习 了 如 何 通过 eos 实 例 的 setcode/setabi 方 法 将 
合约 编译 文件 快速 发 布 到 指定 链 环 境 。 

另外 ， 如 果 为 了 提高 发 布 合约 效 率 ， 我 们 还 可 以 在 
package.json 中 定义 发 布 合约 的 运行 脚本 ， 并 配合 IDE 工 具 中 
的 快捷 键 ， 便 可 达到 开发 效率 的 进一步 提升 。 


在 教程 中 如 出 现 销 旋 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackHook 
号 es 介 才 四 各 加 速 蕉 ~ 去 中 心 交易 所 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 


changelog 
2019-03-12 zhangliang 


。 初次 发 移 


11.4 EOS 索 引 器 Multi-Index 完 整 用 法 及 
示例 讲解 -- 总 目 永 


， 明 本 文 内 容 是 基于 官方 文档 CDT 1.3.2 版 本 进行 教程 编写 


eosiov:multi_index 是 EOS 提 供给 合约 开发 人 员 编 写 合约 时 
持久 化 数据 的 一 种 服务 接口 。 同 时 在 持久 化 过 程 中 可 以 保证 多 
个 action 间 埠 套 事务 的 数据 一 致 性 。 


eosiov:multi_index 本 号 是 在 C++[ Boost.Multilndex 
Containen] 基 础 之 上 进行 扩展 实现 ， 所 以 在 索引 器 的 定义 与 使 
用 上 与 原生 索引 右 大 致 相同 。 该 索引 需 提 供 了 丰富 的 检索 功 
能 ， 支 持 对 不 同 索 引 字 段 的 排序 与 检索 功能 。 


传统 型 的 数据 库 通过 我 们 都 知道 可 以 按照 主键 进行 检索 ， 同 样 
在 索引 硕 也 文 持 基于 主键 检索 。 但 在 EOS 智 能 合约 中 主键 字段 
只 文 持 uint64_t 数 据 类 型 字段 ， 且 在 结构 体 中 必须 实 

现 privary_key() const 成 员 常量 函数 


通过 查阅 官方 文档 ， 发 现 eosioV:multi index 类 内 部 共计 提供 
了 25 个 方法 ， 按 照 日 常 开 发 场景 对 其 进行 分 类 后 ， 可 划分 为 以 
下 四 部 分 : 

定义 如 何 通过 构造 函数 进行 索引 器 定义 , 其 中 包括 主键 、 二 
级 索引 

存储 增 、 删 、 败 方法 

查询 根据 主键 查询 、 基 于 条 件 进 行 区 间 查 询 

。 和 迭代 正 同 迭代 、 反 辐 迁 代 列 表 数 据 


所 以 ， 本 文 将 eosiov:multi_index 的 所 有 知识 点 ， 分 成 四 个 模 
块 讲解 。 每 个 模块 将 会 分 别 通过 方法 功能 、 参 数 说 明 、 方 法 结 


条 及 详细 的 代码 示例 ， 来 帮助 大 家 完 


堪 的 知识 点 。 
章节 目录 


1. Multi-Index 完 整 用 法 及 示例 讲解 --- 
2. Multi-Index 完 整 用 法 及 示例 讲解 -- 
3. Multi-Index 完 整 用 法 及 示例 讲解 -- 
4. Multi-Index 完 整 用 法 及 示例 讲解 -- 


整 的 学 习 与 掌握 整个 索引 


索引 各 定义 篇 


-数据 存储 篇 
-数据 检索 篇 
-迭代 器 篇 


11.5 Multi-Index 完 整 用 法 及 示例 讲解 --- 
索引 右 定义 篇 


本 小 节 将 向 大 家 介绍 如 何 对 自 定义 数据 结构 体 定义 主键 索引 、 
二 级 字段 索引 ， 并 通过 代码 示例 的 形式 方便 大 家 理解 。 


本 文 将 分 两 部 分 进行 知识 点 讲解 : 


普通 索引 定义 
二 级 索引 定义 


1. 普通 索引 定义 


typedef eoSsio::multi index< [TabpleName]，[LT] > [Lan 


索引 定义 主要 由 三 个 参数 进行 定义 : 

TableName: 数据 结构 体 所 对 应 的 表 名 ， 其 名 称 长 度 不 可 超 
过 12 个 字符 ， 且 和 名称 只 允许 由 小 写字 母 、 数 字 1 到 5、. 三 种 字 
符 构 成 。T:， 为 数据 结构 体 名 称 index_type: 索引 磊 类 型 别 
名 。 需 要 针对 不 同 的 结构 体 进 行 不 同 的 索引 右 定 义 。 

因为 缺 省 索引 器 是 基于 主键 时 查询 的 ， 所 以 在 定义 结构 时 ， 需 
内 部 必须 实现 一 个 名 为 primary_key() 且 返 回 值 必 须 为 
Uint64_t 数 据 类 型 的 成 员 利 函 数 。 


要 实现 一 个 简单 的 稼 引 右 定义 ， 可 分 为 以 下 四 个 步 桑 : 
1. 定义 结构 体 


Struct User { 
UInt64 t account_name ，; 


UInt64 t age ; 
】; 


2. 定义 主键 查询 方法 在 上 述 结 构 体 中 ， 实 
现 夺 aaFyYAUKRE7O 方法 


UInt64 t priImary_key() const { return account_ni: 


3. 定义 索引 需 
typedef eoslo::mulLtli index< "USser”n，USser > US 


4. 实例 化 索引 器 在 实例 化 索引 
契 multi_index (name code，uint64_t scope) 时 ， 需 
要 传递 两 个 参数 :， code、scope。code 参 数 指 表 所 归属 的 
合约 帐户 ， 即 你 所 要 查询 或 处 理 的 数据 是 哪个 合约 帐户 下 
面 的 数据 ;， scope 参数 主要 用 于 对 表 数 据 的 分 表 处 理 。 比 
如 按 帐 户 进行 数据 隔离 ，scope 参 数 就 传 入 对 应 帐户 名 。 


USser lndex Userestable(_selLf，_self.vajlue); // 1 


完整 示例 如 下 ; 


#InclLude <eoSs1lIolLip/veosio.hpp> 
USlIng namespace eoSliIo 
USiIng namespace Std; 


Class booking : contract 1 
Struct User { 
UInt64 t account_name ，; 
UInt64 t age 


站 下 下 V AN 全 


UILnE64 L prlmary_Key() consc 4 recurn accounT 
了 / 
puUpbJic : 

booking (name SeJf):contract(sejlf) 1 


typedef eoSsio::multi index< "USser”n，uUser > U 


vold createuser(name User，UiLnt64 t age) { 
USser_index Userestabje(_seJlLf，_seJf,value ) ; 


】} 


】 
EOSIO_DISPATCH( booking ， (myaction) ) 


2. 二 级 索引 定义 


通 间 情况 下 ， 在 实际 的 业务 场景 中 ， 很 可 能 会 对 某 一 张 表 数据 
进行 多 个 字段 的 数据 表 统 计 得 询 。 


那么 ， 这 时 候 了 驶 需要 进行 二 级 索引 定义 。 


typedef eosio::multi index< [TabJeName]，[Tj]， 
Indexed_by< 
[IndexName | ， 
const_mem_fun<[LT]j]，[LIndexFieldType]j]，[LFiel 
之 
> USer_index ， 


与 普通 索引 峰 的 定义 方式 相 比 ， 二 级 索引 多 出 一 
个 indexedN_by 的 扩展 定义 。indexedN_by 需 要 进行 四 个 参数 
定义 : 


Indexed_by< 
[IndexName | ， 
const_mem_fun<[IT1，[LIndexFlieJdType]，[LInde 


IndexName: 二 级 索引 和 名称。 其 命名 长 度 不 可 以 超过 13 个 字 
符 ， 其 中 前 12 个 字符 只 人 允许 由 小 写字 母 、 数 字 1 到 5、. 三 种 字 
符 构 成 ， 第 13 个 字符 只 人 允许 从 ap 小 写字 母 或 .两 类 字符 中 选择 
T:， 数据 结构 体 名 称 IndexFieldType: 二 级 索引 字段 数据 类 
型 。 目 前 所 文 持 的 数据 类 型 仅 文 持 以 下 几 种 


Ulint64 {t 

Ulnt128 ft 

eoslo::checksum256 

double 

long double 。 IndexFieldGetter: 数据 结构 体 属 性 getter 


让 
注 : 索引 器 目前 最 多 支持 16 个 二 级 索引 。 
现在 对 普通 索引 器 所 提供 的 代码 示例 ， 进 行 二 级 索引 扩展 ， 新 
增 age 字 段 二 级 索引 


1. 在 数据 结构 体 中 ， 添 加 二 级 索引 字段 


Struct User { 
UInt64 t account_name ，; 
uint64 t age;  // 新 增 索 引 字 段 


UInt64 t priImary_ key() const { return accoul 


2. 在 数据 结构 体 中 ， 定 义 对 二 级 索引 字段 的 碍 询 方 法 


UInt64 t by _age() const { return age; } 


在 user 数 据 结构 体 中 ， 定 义 对 age 字段 的 查询 方法 
3. 在 索引 器 中 添加 二 级 索引 定义 


typedef eoslo::mulLtli Index< "User”n，User ， 
Indexed_by< 
"byage”n， 
const_mem_fun<user，Uint64 七 &user: :by 
之 
> USer_ Index 


4. 实例 化 索引 右 ， 并 获取 二 级 索引 实例 
//IT.， 实例 化 索引 大 


User_ lndex Userestable(_selLf，_self.vaJlue); // 


4 


auto age_lindex = Userestable.get_index<"byage"” 


通过 本 小 和 的 学 习 ， 我 们 玫 悉 了 整个 和 索 引 万 从 定义 数据 结构 
体 、 主 键 与 二 级 索引 定义 以 及 索引 郁 、 二 级 稼 引 实例 化 的 完整 
开发 流程 。 


在 教程 中 如 出 现 钳 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


HackiHook 和 
马 二 所 才 四 三 加 速 稚 一 去 中 心 交易 所 


changelog 
2019-03-21 zhangliang(mallto:zhangllang@cldy.org) 


。 亡 次 发 移 


11.6 Multi-Index 完 整 用 法 及 示例 讲解 --- 
数据 存储 篇 


上 一 小 和 介绍 了 如 何 针 对 一 个 数据 结构 定义 对 应 的 索引 郝 ， 那 
么 本 小 节 将 介绍 如 何 利 用 eosio:multi_index 所 提供 数据 操作 方 
法 对 数据 进行 添加 、 修 改 、 删 除 。 


1. 添加 方法 


eosio::multi_index::emplace 为 eosio::multi_index 所 提供 的 
添加 方法 ， 其 方法 参数 为 : payer、Lambda function 


const_1Iterator eoslo::muJtli index::empJlace (人 
name payer ， 
Lambda && constructor 


) 


emplace 参 数 说 明 : 


。payer: 文 付 人 源 帐户 。 

即 : 存储 数据 所 需 消 耗资 源 的 文 付 帐 户 

Lambda && constructor: Lambda 画 数 。 

例如 : 

[Cauto& adgdressj ff 7Z7T000 do some stuff 了 |] 另 
外 ， 在 传统 数据 库 表 设计 中 ， 通 党 我们 都 会 将 主键 设置 成 
目 增 类 型 。 那 么 ， 同 样 智 能 合约 中 也 可 以 实现 目 增 ID， 可 
以 通过 索引 器 提供 的 
eosio::multi_index::available_primary_key () 方 法 获取 下 一 
个 ID 并 对 主键 进行 赋值 。 


代码 示例 : 新 建 一 条 用 户 数据 


vold createuser(name Username，Uint64 t age) { 


UsemndEXxusesaestEalDecESSINN SENXaIUGD 2 


USserestabJe,emplace(username，[&lj(Cauto& User ) 
USer ,account_name = Username ; 
USer ,age = age:， 


有 


2. 修改 方法 
eosio::multi_index::index::modify 为 eosio::multi_index 


索引 融 提 供 的 修改 数据 方法 。 


void eosio::multi index: :index::modify (人 
Const_1iterator Itr， 
eoSlio::name payer， 
Lambda && updater 
) 
参数 说 明 : 

。itr 该 参数 主要 用 于 接受 所 要 修 改 数据 实例 对 应 的 
const_iterator 对 象 ， 而 非 对 象 实例 本 号 。const_iterator 对 
象 或 者 可 以 理解 为 数据 实例 的 引用 地 址 。 

。 payer 资源 消耗 付费 帐户 
即 : 修改 数据 所 需 消 耗资 源 的 文 付 帐 户 

e。 Lambda && updater 


例如 : 
[&]j(auto& address) 上 /ZLTODO do Some Stuff 】} 


代码 示例 : 修改 一 个 用 户 的 年 龄 age 属性 


vold modifyuser(name Username，Uint64 t age) { 


USer_index Userestabje(_selLf，_SseJf,value); // 


auto Iter = Userestable.find(Cusername ) ; 


USserestabJle,modify(Iter，USsername，[&](Cauto& U 
USer ,age = age:; 


3. 删除 方法 
eosio::multi_index::erase 辣 样 也 是 由 eosio::multi_index 提 


供 的 数据 删除 方法 。 


const_1iIterator eoslio::muJLtli index::erase (人 ( 
const_1Iterator tr 


) 


参数 说 明 : 
。itr 该 参数 主要 用 于 接收 const_iterator 类 型 实例 。 而 该 类 型 
实例 其 实 就 是 对 表 数 据 实 例 的 地 址 引用 封装 。 


与 添加 、 修 改 不 同 之 处 在 于 : 删除 数据 时 不 需要 指定 资源 文 付 
帐户 。 因 为 删除 数据 相当 于 释放 资源 。 在 开发 过 程 中 ， 征 提倡 
对 无 用 资源 的 及 时 清理 工作 的 。 


vold modifyuser(name Username，Uint64 t age) { 
USer_index Userestabje(_selLf，_SseJlf,value); // 


auto Iter = Userestable.find(Cusername ) ， 


USserestabJje,erase(1Iter ) ; 


通过 本 小 万 的 学 习 ， 我 们 学 会 了 如 何 使 用 multi_index 索 引 的 
emplace、modify、erase 方 法 来 完成 对 合约 数据 的 添加 、 修 
改 、 删 除 操 作 。 


在 教程 中 如 出 现 稍 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail 
zhangliangQ@Qcldy.org 


HackiHook 和 
急 2 所 才 四 矶 加 速 览 一 去 中 心 交易 所 
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Multi-Index 完 整 用 法 及 示例 讲解 --- 数 据 检 


在 本 小 站 ， 将 会 为 大 家 讲解 五 种 数据 查询 方法 : find、require_ find、 
get、|lower_bound、upper_bound 。 

find 

功能 :， 基于 主键 或 二 级 字段 索引 快速 查询 某 条 数据 ， 并 返回 


const iterator 和 迭代 器 实例 


const_iterator eosio::mulLti index::find (人 
Uint64 t primary 
) const 


参数 说 明 : 


。primary 接收 主键 值 返回 结 和 采 : ， 村 查 询 时 ， 
可 通过 和 迭代 器 进行 循环 碍 询 , 会 在 欠 代 器 小 
节 文 章 中 进行 介绍 。 


代码 示例 : 人 
//IL， 实 例 化 索引 器 


User_index Userestable(_self，_Sself,.value)，// code，Sscope 


//2.， 查询 用 户 
auto iter = userestable,find(1)， // 此 处 直接 返回 便 是 const_iter: 


//3， 业 务 逻 辑 上 断言 
eoSsSlio_assert(Itr->account_name == 1， "Incorrect USser ")， 


注 : userestable.find(1) 方 法 返回 的 const_iterator 对 象 ， 如 果 想 要 访问 
实例 属性 ， 是 需要 按照 指针 调用 的 形式 进行 获取 。 比如 : iter-> 
account_name， 只 有 直接 通过 数据 结构 体 进 行 实例 化 时 ， 才 会 使 用 
useraccount name 的 形式 获取 属 性 值 。 比如: 


USer newinstance = USser();， newinstance,account_name = "XXXx"”; 


O 〇 


require_find 


功能 :， 基于 主键 字段 索引 快速 查询 革 条 数据 ， 并 返回 const_iterator 迭 
代 器 实例 。 如 知 不 存在 ， 则 抛 出 事先 定义 的 例外 。 


const_iterator eosio::multi index: :reduire_ find (人 
Uint64 t primary， 
const char * error_msg = "unabJle to find keyy" 
) const 


参数 说 明 : 


e。 primary 

所 要 查询 的 主键 字段 值 

。error_msg 

所 要 查 询 的 数据 不 存在 时 ， 所 要 抛 出 的 例外 信息 。 如 果 不 定 义 则 默认 
使 用 unable to find key 提 示人 信息 。 返回 结果 : 当 对 二 级 字段 索引 进 
行 查 询 时 ， 可 能 会 检索 到 多 条 数据 记录 ， 可 通过 迭代 器 进行 循环 查询 ， 
会 在 迭代 胡 小 世 文 章 中 进行 介绍 。 


代码 示例 : 查询 主键 值 为 1 的 用 户 


//L， 实 例 化 索引 右 
User_index Userestable(_self，_Sself,.Vvalue)，// code，Sscope 


/7V2， 查询 用 户 
auto iter = USserestable.reduire_find(1，"not found object 


// 以 上 代码 方式 ， 其 实 与 下 面 的 实现 逻辑 相同 。 
auto Iter = USserestable.find(1I)， 
eoSslio_assert(itr != USserestable,end()， "not found object" ) ， 


注 : 在 业务 开发 中 ， 可 根据 不 同 场景 选择 使 用 find 还 是 redquire_find。 对 
于 不 允许 为 空 的 情况 ， 可 以 使 用 require find 方式 使 代码 更 加 简洁 ; 但 如 
果 是 需要 根据 是 否 为 空 处 理 不 同 的 逻辑 ， 则 可 以 find 方 式 并 配合 值 判 空 条 
件 来 处 理 不 同业 务 逻 辑 。 


get 


功能 : 基于 主键 字段 索引 快速 某 条 数据 ， 并 返回 其 数据 对 象 。 


const T & eosio::multi index::get (人 

Uint64 t primary， 

const char * error_msg = "unable to find keyy" 
) const 


参数 说 明 : 


。primary 主键 参数 
。error_ msg 例外 消息 。 可 目 行 定义 消息 内 容 。 


代码 示例 : 查询 主键 值 为 1 的 数据 实例 


//L， 实 例 化 索引 器 
USser_index Userestable(_self，_Sself,.value)，// code，Sscope 


UserestabJle.empJace(_seJf，[&]l(auto& s)({ 
S,account_name = 工 ; 
s.age = 18， 


抽 克 


//2， 查 询 用 户 
User user = Userestable.get(1，"not found object")，V/ 此 处 直 


//3. 访问 并 打印 用 户 名 称 


print User,account_name 


lower bound 


功能 : 基于 主键 或 二 级 字段 索引 ， 查询 大 于 或 等 于 指定 参数 的 
const iterator 和 大 代 器 对 象 。 


const_iterator eoslio::multli index::1Lower bound (人 
Uint64 t primary 
) const 


参数 说 明 


e。 primary 
主键 字段 值 返回 结果 : 当 对 二 级 字段 索引 进行 查询 时 ， 可 能 会 检索 到 
多 条 数据 记录 ， 可 通过 迭代 万 进行 循环 得 询 , 会 在 迭代 融 小 和 文章 中 
进行 介绍 。 


代码 示例 : 查询 年 龄 小 于 10 的 用 户 列表 


User_index Userestable(_self，_Sself,.value)，// code，Sscope 


Userestable.empJace(_seJf，[&](auto& s)({ 
S.account_name = 工 ; 
sS.age = 19， 
】 了 ) 
Userestab]le.empJlace(_seJf，[&](auto& s)({ 
S.account_name = 2 ， 
sS.age = 18， 
】 了 ) 
USserestab]le.empJace(_seJf，[&](auto& s){ 
sS.account_name = 3， 
S.age = 1 


了 


auto agestable = USserestable.get_index<"byage"”n>() 


// 碍 询 年 龄 大 于 且 等 于 18 的 用 户 列表 数据 


auto iter = agestable.Lower_bound(18 ) ， 


eosio_assert(iter->account_name == 2， "Incorrect First Lowe 
ee 
eosio_assert(iter->account_name == 1， "Incorrect Second Lo 
是 ee 
eoSlo_assert(1iter == agestabJle.end()， "Incorrect End of It 


Upper bound 


功能 : 基于 主键 或 二 级 字段 索引 ， 查询 小 于 或 等 于 指定 参数 的 
const iterator 从 代 器 对 象 。 


SN 


const_iterator eosio::multi index::upper_ bound (人 
Uint64 t primary 
) const 


参数 说 明 : 


。primary 

| En 询 时 ， 可 能 会 检索 到 
多 条 数据 记录 ， 可 通过 和 迭代 需 进 行 循 环 碍 询 , 会 在 迭代 妖 小 和 文章 中 

进行 介绍 。 


代码 示例 : 


User_index Userestable(_self，_Sself,.Vvalue)，// code，Sscope 


USserestab]le.empJlace(_seJf，[&](auto& s)({ 
S.account_name = 工 ; 
sS.age = 19， 
】 了 ) 
Userestab]le.empJace(_seJf，[&](auto& s)({ 
S.account_name = 2， 
s.age = 18， 
】 了 ) 
Userestab]le.emplace(_seJf，[&](auto& s)({ 
s.account_name = 3 
SsS.age = 工 ; 


所 


auto agestabjle = USserestable.get_index<"byage"”n>() 


查询 年 龄 小 于 且 等 于 18 的 用 户 列表 数据 
Iter = agestable.upper_bound(18 ) ， 


eoSslio_assert(1Iter->account_name == 3， "Incorrect First Uppe 
JESLPonnny 
eoSlio_assert(1Iter->account_name == 2， "Incorrect Second Up 
Eee 


eoSlio_assert(1iter == agestabJle.end()， "Incorrect End of It 


通过 本 小 和 学 习 ， 我 们 学 会 了 如 何 基于 主键 索引 、 二 级 索引 完成 我 们 对 
合约 数据 的 单条 数据 得 询 或 区 间 数 据 查 询 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 指正 ! 
Name: zhangliang | WecChat': rushking2009 | Mail: 
zhangliang@cldy.org 
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11.8 Multi-Index 完 整 用 法 及 示例 讲解 --- 

迭代 器 篇 

在 eosio::multi_index 类 中 共计 提供 了 cbegin、begin、 

crbegin、rbegin、cend、end、crend、rend 八 个 欠 代 方法 ， 
共计 四 对 对 称 方法 


。 cbegin/cend 
e。 beglin/end 

。 crbeglin/crend 
e。 frbegin/rend 


虽然 以 上 四 对 方法 名 称 均 有 所 不 同 ， 但 从 其 源码 实现 上 可 以 归 
为 两 种 : 


。 正 癌 迭 代 厦 
cbeglin/cend、beglIn/end 
。 反 转 色 代 天 


crbeglin/crend、rbegin/rend 
可 参考 其 具体 源码 : 


const_iterator cbegin()const 1{ 
USiIng namespace _mulLtli_ index_detal]:， 
return Jower_bound( Secondary_key_tralits<secon 


】} 


const_iterator begin()const 1{ return cbegin(); } 


const_1Iterator cend( )const { return const_iIterator 
const_1iIterator end()const 1{ return cend()，} 


const_reverse_iterator crbegin()const { return std 
const_reverse_iterator rbegin()const ({ return crb 


const_reverse_iterator crend( )const { return std 
const_reverse_iterator rend( )const { return cre 


正 辐 迭代 吉 其 实 束 是 按照 索引 由 低 到 高 的 顺序 进行 届 历 ， 而 反 
转 友 代 器 其 实 束 是 将 正 回 迭代 器 进行 了 反 转 操作 ， 即 按照 索引 
高 到 低 的 次 序 进行 笛 历 。 

而 所 有 迭代 硕 begin 都 特 指 当 前 排序 的 首 个 对 象 实例 ， 而 end 都 
特 指 当前 排序 末尾 结束 符 ， 注 意 并 不 是 最 后 一 个 对 象 实例 。 
正 向 迭代 器 (cbeginicend、beginjend) 

功能 : 按 索引 由 低 高 到 的 次 序 进 行 数据 遍历 

代码 示例 


USser_index Userestabje(_selLf，_self,value);， // cod 


USerestabJe,emplace(_self，[&l]l(Cauto& s){ 
S,account_name = 工 ; 
S,.age = 19， 
了 ) ) 
USserestabJe,emplace(_self，[&l]l(Cauto& s){ 
S.account_name = 2 
S,age = 18; 
了 ) / 
USserestabJe,emplace(_self，[&l]l(Cauto& s){ 
S,.account_name = 3， 
S,age = 工 ; 


的 


auto agestabje = USserestable,.get_index<"byage”n>( 


// 正 同 迭 代 ， 和 索引 由 低 到 高 的 顺序 


auto Iter = agestable.begin();， // or agestabJle.cbe 


eoSlio_assert(1Iter->account_name == 3， "Incorrect F 
2 罗 
eoSlio_assert(Iter->account_name == 2， "Incorrect S 
ee 
eoSlio_assert(Iter->account_name == 1， "Incorrect T 
Iter++， 
eoSlio_assert(iter == agestable.end()， "Incorrect E 


反 转 迭代 器 〈crbeginjcrend、rbeginjirend ) 
功能 : 按 索引 由 高 到 低 的 次 序 进 行 数据 所 历 
代码 示例 


USer_index Userestabje(_selLf，_self,value);， // cod 


USserestabJle,emplace(_self，[&l](Cauto& s){ 
S,account_name = 工 ; 
S,.age = 19， 
了 ) 
USserestabJe,emplace(_self，[&l]l(Cauto& s){ 
S,account_name = 2 
S,.age = 18， 
了 ) 
USserestabJe,.emplace(_self，[&l]l(Cauto& s){ 
Ss,.account_name = 3， 


入 mn 一 1， 


Digudc 一 上/ 


已 


auto agestabje = USserestable,.get_index<"byage”n>( 


// 反 转 适 代 ， 索 引 由 高 到 低 的 顺序 


auto Iter = agestab]le.rpbpegin();， /Lor agestabJle,crb 


eoSlio_assert(Iter->account_name == 1， "Incorrect F 
Iter++， 

eoSlio_assert(Iter->account_name == 2， "Incorrect S 
Iter++， 

eoSlio_assert(Iter->account_name == 3， "Incorrect T 
3 交 蕊 2 的 风 罗 。 

eoSlio_assert(1Iter == agestabJle.rend()， "Incorrect 


最 后 ， 让 我 们 回顾 一 下 整 篇 文章 的 知识 点 。 首 次 ， 讲 解 了 如 何 
针对 数据 结构 体 进 行 主 键 及 二 级 索引 字段 的 索引 器 定义 ; 然 
后 ， 讲 解 了 如 何 利用 索引 天 对 数据 进行 添加 、 修 改 、 删 除 操 
作 ; 紧 接 着 ， 又 讲解 了 如 何 对 合约 表 数 据 进 主键 、 二 级 索引 字 
段 进 行 单条 记录 、 区 间 记 录 碍 询 ， 最 后 ， 又 讲解 了 如 何 利 用 和 迭 
代 万 对 数据 正 同 或 反 同 进行 笛 历 。 


11.9 巧 用 HistoryApiAction 实 现 对 链 数 
据 的 存储 与 查询 


巧 用 HistoryApiAction 实 现 对 链 数据 的 存 
储 与 查询 

在 开发 EOS DApp 智 能 合约 时 ， 我 们 都 知道 可 以 使 

用 multi\_index 来 对 合约 数据 的 存储 与 查询 ， 但 合约 的 存储 
是 需要 消耗 一 定 的 资源 的 ， 而 且 随 着 用 户 的 增长 往往 会 导 业 务 
数据 会 越 来 武大 ， 从 而 导致 合约 需要 更 多 的 资源 来 支撑 其 数 
据 。 


有 时 我 们 可 以 通过 业务 设计 ， 让 业务 数据 得 到 即时 清理 及 资源 
释放 。 但 大 多 数 情况 下 ， 业 务 数据 征 不 允许 清理 的 ， 那 么 针对 
这 种 情况 是 否 有 其 他 办 法 来 降低 对 合约 存储 唤 源 的 应 耗 呢 ? 


那么 ， 今 天 分 享 的 方案 丈 是 : 借用 EOS 链 提供 
的 historyN_api_action 插件 服务 、 内 部 合约 Action 调 用 来 
完成 对 业务 数据 的 存储 与 查询 。 


举 个 : 在 去 中 心 化 交易 所 中 ， 往 往 搓 合 成 功 会 产生 大 量 的 成 
交 订 单 ， 那 保存 在 合约 数据 库 中 肯定 是 不 合适 的 ， 所 以 可 以 在 
搓 合 方法 中 通过 调用 内 部 日 志方 法 的 形式 ， 通 过 交易 日 志 来 将 
订单 数据 写 入 区 块 中 ; 然后 通过 EOS 节 点 提供 的 查询 历史 
action 接 口 ， 碍 询 合约 日 志 数 据 并 增 量 同 步 到 中 心 化 数据 库 。 


下 面 ， 我 们 将 通过 具体 的 代码 示例 来 帮助 大 家 理解 整个 过 程 : 


首先 ， 我 们 新 创建 一 个 合约 
(dexchange.hpp/dexchange.cppy); 


//dexchange .hpp 


#InclLude <eos1lIolLip/veosio.hpp> 
#InclLude <eos1lIolLipZprint.hpp> 


USIng namespace eoSlio 
CONTRACT dexchange : pub]lic contract 1{ 
pupbJ1ic : 
USliIng contract: :contract ; 


dexchange(eosio: :name recelver，eosio: :name co 


[Leosio::actionj]j 
vold executetrade(uint64 tt palir 1d，UuUint64 t s 


[Leosio::actionj]j 
void Log(Cuint64 t deal_price，Uint64 t quantit 


了 / 
EOSIO_DISPATCH(dexchange， (executetrade)(]1og ) ) 


//https://gist,github.com/Z2b68242019242bdd12f17420 


然后 ， 定 义 并 实现 两 个 方法 : executetrade、log 。 
executetrade 合约 方法 负责 搓 合 业务 ， 当 搓 合 业务 处 理 完 之 
后 调用 1og 方 法 ， 通 过 交易 信息 将 参数 调用 数据 写 入 区 块 中 ; 


//filename: dexchange, cpp 
#Include "dexchange ,hpp" 


vold dexchange: :executetrade(uint64 t palir 1d，ULn 
NTn+A4 了 + neal nrire 二 1200 


WII 下 鳃 WU NS“ -~L 忆 =L vv 三 二 二 一 


Uint64 t quantity = 10000 


actlion( 
permiSsslion JeveJl{ _sejlf， "active”n 省 
_SeJf， "Log”n 
std::make _tuple(deal_price，palr Id，sell_ or 
) .Send () / 
) 


vold dexchange: :Log(Cuint64 t deal_price，Uint64 七 
requlire_auth( _SseJlLf ) 


】} 


/https://gist.github.com/ea6ec431a57faee3a2823cfe 


从 以 上 示例 可 以 看 出 ， 合 约 log 日 志方 法 其 实 并 不 需要 做 任何 
业务 逻辑 处 理 。 只 需要 间接 被 调用 ， 便 可 将 我 们 需要 的 业务 数 
所 通过 才 交 易 的 形式 记录 在 区 块 中 ， 而 不 会 痕 费 我 们 的 合约 存储 
空间 ， 也 不 需要 担心 资源 释放 的 问题 。 


下 一 步 、 发 布 智能 合约 ， 并 调用 一 次 executetrade 合 约 方法 


光 这 而 合 汪 于 hanDeehi 久 丰 局 
> Cleos Set contract hackdappexch contracts/ -p _h 


// 执 行 合约 方法 


> Cleos push action hackdappexch executetrade [1， 


最 后 ， 通 过 EOS 链 节点 提供 的 RPC 服 务 ， 进 行 历史 action 数 据 
查询 ， 通 过 数据 过 滤 找到 我 们 的 日 志方 法 及 参数 数据 。 


| 我 们 使 用 curl 命 令 查 询 其 对 应 


cuUr --request POST NA 
--UrJl https://Localhost:8888/v1V/history/vget_act:j 


--header "content-type: applLication/Zx-www-form- 
--data '{"pos":-1,， "offset":-10,"account_name"”:"h 


通过 此 接口 得 询 出 来 的 数据 不 仅仅 是 1og 合 约 方法 数据 ， 可 能 
ee 需要 根据 情况 再 过 滤 一 次 数 
必 


补充 说 明 


如 果 你 在 本 地 曾经 搭建 过 EOS 私 链 的 化 ， 那 么 或 许 看 到 过 ， 
EOS 司 动 时 是 可 以 配置 不 同 插件 。 而 其 中 有 一 个 插件 
history_api_plugin， 葡 是 用 于 监听 并 存储 合约 方法 的 调用 信 
妃 ; 另外 局 动 链 世 点 时 ， 是 可 以 按 规划 目 由 指定 所 要 监听 的 合 
约 帐 户 及 方法 ， 如 :，--filter-on hackdappexch::log, 该 参数 
配置 表示 只 监听 hackdappexch 合 约 中 的 Ilog 方 法 。 


nodeos -e -p eosilio -d ZXZmntvdev/vdata \\ 
--Config-dir ZXmntvdevvconf1ig 和 
--http-validate-host=false \\ 
--plLugin eoslo::producer_ plLugin \ 
--pLlugin eosio::chain api plugin AN 
--pLugin eosio::http_plugin 
--pLlugin eosio::history_ apli_ plLugin 和 
--http-Sserver-address=0.0,0.0:8888\ 
--acceSSs-controlL-alLJow-orligin=* 和 
--ContractSs-console \ 
--flLlLter-on hackdappexch:]og: 和 
--max-tranSsaction-time=1000 \ 
--Verbose-http-errors & 


如 以 上 EOS 贡 点 启动 命令 ， 歼 展示 了 局 动 一 个 EOS 贡 点 的 具 
体 参 数 配置 。 其 中 ，- -filter-on 参数 便 是 指定 只 监听 记 
孙 hackdappexch 合约 的 1og 方法 调用 数据 。 


所 以 ， 当 我 们 要 通过 链 节 点 RPC 服 务 查询 合约 方法 历史 调用 数 
据 时 ， 需 要 先 确认 提供 RPC 服 务 的 节点 是 否 开 启 了 
history_api_plugin 插 件 ， 以 及 自己 所 要 得 询 的 合约 是 否 在 其 过 
滤 规 则 之 中 。 


小 结 


通过 本 篇 文章 ， 我 们 学 会 了 利用 内 部 合约 方法 调用 + 链 节 点 历 
史 Action 碍 询 的 方式 实现 业务 数据 的 羽 一 种 数据 存储 与 查询 方 


了 人 


在 教程 中 如 出 现 销 误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Mail: 
zhangliang@Qcldy.org 
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11.10 如 何 根据 业务 场景 选择 合适 的 
(Deferred Action、Inline Action) 


EOS 智 能 合约 中 支持 两 种 Action 进 行 合 约 间 方法 调用 。lnline 
actions 可 理解 为 同步 执行 操作 ; Deferred actions 为 异步 执 
行 操作 。 


Inline actions， 强 调 在 同一 事务 中 的 关联 方 污 拥有 与 调用 入 
口 方法 相同 的 权限 。 它 们 可 以 傈 证 当前 关联 方法 中 的 任何 一 个 
方法 出 现 错误 ， 都 会 回 入 整 个 交易 数据 。 另 外 ， 需 要 说 明 的 是 
一 个 交易 中 的 所 有 方法 都 是 在 同一 个 区 块 中 执行 的 。 


Deferred actions， 是 合约 设 定 为 将 来 某 一 个 时 刻 进行 执行 的 
方法 。 它 与 Inline actions 不 同 之 处 在 于 : 它 不 能 保证 被 执 
行 。 因 为 合约 方法 内 进行 Deferred action 调 用 时 ， 也 就 意味 
着 新 开启 了 一 个 事务 。 而 这 个 事务 最 终 能 否 被 生产 节点 所 接受 
其 实 并 不 能 确定 。 但 即使 是 失败 ，Deferred action 也 并 不 会 
对 源 方法 造成 数据 回 滚 影响 ， 因 为 当 延 迟 方法 开始 执行 时 ， 可 
能 源 方法 所 在 区 块 已 经 被 生产 出 来 了 。 


可 能 有 人 会 问 ， 有 既然 Deferred actions 不 能 确定 是 否 被 执行 成 
功 ， 那 么 它 还 有 存在 的 意义 吗 ? 


其 实 ，Deferred actions 在 实际 开发 场景 中 ， 确 实 是 有 其 存在 
的 意义 。 只 不 过 需要 结合 不 同业 务 场景 使 用 ， 不 妨 想 一 想 ， 我 
们 一 个 合约 方法 中 可 能 业务 逻辑 稍微 复杂 一 些 ， 而 EOS 链 又 要 
求 所 有 的 合约 方法 执行 时 间 不 可 超过 30ms， 那 很 可 能 复 杂 的 
方法 就 无 法 执行 了 。 但 如 果 这 时 ， 你 将 一 些 非 强 事 务 型 的 方 
法 ， 进 行 抽取 改 为 异步 执行 ， 这 样 束 优化 方法 的 执行 时 间 确 保 
合约 方法 的 正常 执行 。 


那么 ， 哪 些 情况 征 属 于 非 强 事务 型 的 方法 呢 ? 


比如 : 日 志 记录 ， 可 重复 执行 的 方法 〈 即 异 步 执行 出 错时 ， 我 
们 可 以 通过 手动 调用 来 弥补 错误 ) 。 
接 下 来 ， 我 们 通过 示例 代码 的 形式 ， 让 大 家 理解 整个 过 程 : 


首先 ， 创 建 一 个 新 的 合约 , 定义 两 个 方 
法 send 、deferred 。 在 send 方法 中 发 起 对 deferred 方 
法 的 延迟 调用 


void dexchange: :deferred(Cname from，const std: :str 
requlire_auth(from) ， 
print("Printing deferred "”，from，message ) ; 


可 


vold dexchange: :send(Cname from，const std::string 
requlire_auth(from) ， 


eoSlio::transaction 七 {}; 
t,.actions.emplace_back( 
action( 
eoSslio: :permiSsslion level(Cfrom， "active" 
_SeJf， 
“deferred nmn， 


std::make_tuple(from，message ) 
) ; 


t,delay_ sec = delay ; 
t,Ssend(Cnow()，Tfrom) ; 


pantescheduledewnthneasdelaynofe delayy) 


然后 ， 再 定义 一 个 onError 方法 ， 当 EOS 链 发 现 延 迟 方法 执 
行 失 败 时 ， 会 由 系统 触发 合约 中 的 onError 方法 ， 返 回 错误 
言 息 
vold onError(const onerror &error){ 
print("Resending Transaction: "”，error .sender 
transaction dtrx = error,Uunpack_sent_trx(); 
dtrx,delay sec = 3; 
dtrx,Ssend(Cnow()，_ sejlf) ， 


下 一 步 、 定 义 安定 义 ， 根 据 系统 通知 来 决定 如 何 路 由 请 求 。 


extern CC 1 
vold appJy(uint64 t recelver，Uint64 tt code，UiILn 


If (code == "eoslio”n.value && action == "oner 
eoSlio: :execute_action(eosio::name(receliver 
If (code != recelver ) 
return ， 


Switch (action) 
EOSIO_DISPATCH_HELPER(dexchange， (send) (d 
了 
eoS1lIo_exit(0) ; 
】} 


上 面 这 个 代码 示例 中 ，apply 方 法 可 以 看 到 有 三 个 参数 : 
receiver、code、action. receiver 人 参数 就 是 我 们 合约 的 帐户 
名 ; code 的 是 要 取决 于 合约 方法 调用 方 ， 假 如 是 合约 调用 自 
已 内 部 的 方法 ， 那 么 code 与 receiver 一 致 ， 假 如 是 其 他 合约 调 
用 本 合约 的 方法 ， 则 code 为 其 他 合约 的 帐户 名 ; 至 于 action 便 
是 调用 的 方法 名 称 。 


在 这 里 之 所 以 使 用 宏 定义 ， 就 是 因为 在 实际 的 开发 场景 中 ， 我 
们 往往 需要 判断 code 来 判断 是 不 是 合法 的 合约 帐户 发 送 过 来 
的 请 求 。 比 如 : 进行 交易 所 EOS 资 金 充 值 时 ， 往 往 交 易 合约 是 
根据 收 到 eosio.token 的 transfer 消 息 通 知 时 才 会 进行 交易 所 资 
金 的 修改 ， 如 果 不 在 宏 定义 处 通过 code 判 断 消 息 来 源 ， 那 很 
可 能 就 会 造成 假充 值 。 

最 后 ， 发 布 智能 合约 ， 调 用 send 合约 方法 来 进行 测试 。 另 
外 ， 延 迟 方法 在 没有 执行 之 前 ， 其 实 是 可 以 通 

过 cance1l_deferred 方法 进行 交易 取消 的 。 


小 结 


通过 本 文 的 学 习 ， 我 们 了 解 到 deferred 与 inline 方法 间 的 
差异 性 以 及 如 何 根据 业务 场景 选择 不 同 的 方法 进行 代码 实现 。 


在 教程 中 如 出 现 错误 或 不 易 理解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat': rushking2009 | Mail: 
zhangliang@Qcldy.org 


注 ， 有 想 了 解 愿 码 全 思维 IT 工程 师 加 速 器 的 朋友 ， 可 以 扫 码 
加 群 咨询 。 
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11.11 快速 搞 懂 EOS 合 约 的 增删 改 查 以 及 
高 级 技巧 


相信 很 多 开发 朋友 在 学 习 一 项 新 技术 的 时 候 ， 往 往 考 虑 的 第 一 
件 事 可 能 殉 是 如 何 保存 我 们 的 业务 数据 。 不 管 是 JavaWeb， 
还 定 GO， 或 者 Node 项 目 ， 都 希望 能 够 摘 明 日 它 的 数据 存储 技 
术 。 


那么 ， 在 智能 合约 中 是 如 何 进行 对 数据 的 增删 改 查 功能 的 呢 ? 
征 相 对 复杂 还 是 简单 的 呢 ? 


本 小 和 将 带 你 从 一 个 简单 示例 入 门 ， 逐 一 了 解 在 整个 操作 开发 
过 程 所 要 完成 的 各 个 技术 点 。 让 你 从 一 个 基础 的 demo 示 例 了 
解 ， 到 理解 整个 完整 开发 流程 ， 最 后 掌握 合约 存储 高 级 应 用 

API 及 技巧 。 


file: userlist.hpp 


#InclLude <eos1lIolLip/veosio.hpp> 
#InclLude <eos1lIolLipZprint.hpp> 


USlIng namespace eoSilo 
CONTRACT User]list : pubJlic contract 1{ 
pupbJ1ic : 
USliIng contract: :contract ; 


USerlList(eoslo::name recelIver，eoslio::name cod 


[Leosio::actionj]j 
vold add(std::string username，Uint64 t age)， 


[Teoslio: :action1| 


void modify(uint64 t 1d，std::string Username， 


[Leosio::actionj]j] 
vold delL(Cuint64 七 Id) ; 


prIvate: 


struct  [[eosio: :table]] tb user { 
UInt64 tt Id ;， 
std::string Username ; 
UInt64 t age ; 


UlInt64 t primary_key() const { return Id; } 


UInt64 t byage() const { return age } 


了 

typedef eoslio::multl lindex< "tbJuser ”nn，tbl_ us 
Indexed_ by< "byage”n，const_mem_fun<tb]_u 

> USer_ index ; 


3 


EOSIO_DISPATCH(userlist，(add)(modify)(del)) 


filename: userlist.cpp 


#Include "User1List.hppy" 


vold USserJist::add(std::string Username，UiInt64 苇 
USerlList::user _ index User_ stable(_seJlLf，_code,Vva 


USer_stabJe,emplace(_self，[&l(C auto& s ) 并 
sS,. id = User stabJje,avallabJe_primary_key() ， 
s,USsername = USsername ; 
sS,age = age'， 


3 
} 


void userJlList::modify(uint64 t id，std::string Use 
USerlList::user index User stable(_seJlLf，_code,Vva 
auto Item = USser stable.find(1Id ) ， 


eoSlio_assert(1Item != USer_stable.end()， "the dat 


USer_stabje,modify(Item，_SseJf，[&l(Cauto& S)({ 
s,USsername = Username ; 
sS,.age = age'， 

思 


vold USserJist::delL(Cuint64 tt Id) 
USerlList::user index User stable(_seJlLf，_code,Vva 
auto Item = User stable.find(1Id ) ， 


eoSlio_assert(Item != USer_stable.end()， "the dat 


USer_stabJje,erase(1Item) ，; 


以 上 示例 完整 展示 一 个 具有 增 、 删 、 改 、 碍 操作 的 用 户 管理 合 
约 示 例 。 而 完成 这 样 一 个 功能 ， 至 少 需要 完成 两 部 分 代码 定 


义 : 

。 表 及 结构 体 定义 

结构 体 是 业务 数据 的 存储 载体 ， 而 表 是 业务 数据 所 要 持续 
化 的 数据 库 

合约 方法 定义 

合约 方法 为 操作 合约 数据 的 唯一 入 口 。 而 操作 合约 数据 的 
方式 也 是 需要 通过 一 个 名 为 muTti_ indeX 的 索引 器 来 完成 
实现 。 


接 下 来 ， 我 们 将 分 解 介绍 每 个 实现 步 又 以 及 中 间 的 注意 事项 ; 
第 一 步 、 定 义 结 构 体 ， 创建 用 户 对 象 结 构 


struct [[eosio::tablejl]j tp user 1{ 
UInt64 tt 1Id， 
std::string Username ; 
UInt64 t age ; 


UiInt64 t primary_key() const { return Id; } 
了 / 
定义 结构 体 时 ， 需 要 根据 实际 业务 模型 字段 大 小 选择 相应 的 数 
据 类 型 ， 因 为 在 智能 合约 中 存储 任何 数据 都 需要 背 耗 货 源 。 
[[eosio: :table]] 注 解 用 于 标识 在 智能 合约 存储 系统 中 创建 
与 结构 体 一 致 的 表 。 
第 二 步 、 定 义 主键 字段 


一 定 要 实现 primary_key() 缺 省 方法 ， 用 于 告诉 和 引 砷 主键 字 
段 是 哪个 字段 ， 而 且 注 意 该 方法 为 常量 方法 。 


尺 外 ， 可 能 我 们 有 需求 需要 根据 年 龄 进行 数据 查询 ， 这 样 的 
化 ， 也 必须 针对 年 龄 字段 的 实现 相应 的 查询 方法 。 比 如 : 


UInt64 t getbyage() const { return age; } 


第 三 步 、 定 义 合约 方法 

从 开头 示例 中 ， 可 以 看 出 对 数据 的 查询 及 操作 ， 都 必须 用 

到 multi_index 类 型 定义 。 那 么 它 到 展 是 什么 呢 ? 
multi_index 为 EOS 智 能 合约 的 数据 库 访 问 接口 API， 它 提供 
了 对 数据 的 应 加、 修改、 删除 、 主 键 查询 、 多 索引 查询 以 及 多 
种 循环 方式 。 后 续 我 们 将 会 有 一 个 章 下 ， 集 中 介绍 介绍 它 的 多 
种 查询 及 循环 方式 。 


1) 添加 


vold USserJist::add(std::string Username，UiInt64 苇 
USerlList::user index User stable(_seJlLf，_code,Vva 


USer_stabJe,emplace(_self，[&]l( auto& s ) 六 
sS, Id = User stabJje,avallabJe_primary_key() ， 
s,USername = Username ; 

SsS,age = age'， 

了 ) 

】} 


上 还 代 码 展 示 了 如 何 保存 一 条 用 户 数 据 到 智能 合约 中 。 首 移 ， 
我 们 需要 根据 事先 定义 的 索引 userlist::user_index 进 行 实 
例 化 ， 实 例 化 时 需要 传 入 两 个 参数 。 第 一 个 参数 即 表 的 归属 
合约 帐户 ， 即 这 张 表 属于 哪个 合约 。 如 果 查 询 的 是 目 己 合约 的 


表 ， 束 传 入 目 己 合约 的 合约 帐户 名 ; 如 果 碍 询 的 是 其 他 合约 中 
的 表 ， 则 需要 传 入 对 方 合 约 的 合约 帐户 名 ; 第 二 参数 为 数据 的 
存储 维度 ， 可 以 理解 为 分 库 或 分 表 逻 辑 。 例 如 : 此 参数 传 用 的 
是 用 户 名 称 ， 则 代表 按 用 户 维 度 隔离 彼此 的 数据 。 

User _ stable emplace( self [& (00atog& s 让 交行 代码 为 
保存 数据 的 索引 方法 ， 第 一 个 参数 代表 谁 将 为 此 次 数据 存储 文 
付 相 应 的 资源 消耗 。 如 果 为 _selLIf 则 代表 由 合约 本 身 支 付 ， 如 
采 为 用 户 上 自己 则 代表 用 户 需 要 为 此 文 付 资源 消耗 。 


user_stable.available_primary_key 该 行 代码 展示 了 如 何 
获取 主键 字段 自 增 id 值 。 
2) 修改 


vold USserJist::modify(Cuint64 t Id，std::string Use 
USerlList::user index User stable(_seJlLf，_code,Vva 
auto Item = User stable.find(Id ) ， 


eoSlio_assert(1Item != USer_stable.end()， "the dat 


USer_stable,modify(Item，_SseJf，[&l(auto& S)1{ 
s,USsername = Username ; 
SsS,.age = age'， 


修改 方法 与 添加 方法 的 不 同 之 处 在 于 : 需要 使 用 《查询 fnd、 
修改 modify) 两 个 方法 才能 完成 数据 的 更 新 操作 ， 即 先 从 库 中 
ee 


eosio_assert 方 法 主要 用 于 对 参数 或 业务 逻辑 判断 的 断言 处 
理 。 


到 行 代 
码 第 一 个 参数 为 需要 修改 数据 的 地 址 引用 ， 第 二 个 参数 为 谁 为 
此 次 修改 操作 花费 相应 的 资源 消耗 。 


3) 删除 


vold USserJist::delL(Cuint64 tt Id) 革 
USerlList::user index User stable(_seJlLf，_code,Vva 
auto Item = USser stable.find(1Id ) ， 


eoSlio_assert(1Item != USer_stable.end()， "the dat 


USer_stabJle,erase(1Item) ，; 


删除 方法 也 是 需要 和 驳 定位 到 修改 对 象 的 地 址 引用 ， 然 后 通 
过 erase 进 行 合 约 数据 删除 操作 。 


需要 注意 的 是 ，multi_index 本 身 并 未 提供 清空 整 张 表 的 AP 
方法 ， 所 以 如 果 要 清空 数据 表 只 能 选择 循环 迭代 的 方式 一 个 个 
进行 删除 操作 。 但 需要 按 以 下 方式 进行 删除 ; 


// 清 空 表 数 据 
USerlList::user index User_stabje(_seJlLf，_code,Vvalu 
auto Itr = User_stable.begin()，; 
whlile(itr != USer_stable.end() )({ 
Itr.earse(Itr); 


/7 注意 : 不 可 以 添加 itr++ 


4) 查询 


在 智能 合约 实现 中 ， 往 往 我 们 不 需要 对 外 提供 数据 查询 的 合约 
方法 ， 因 为 EOS 节 点 服务 文 持 我 们 通过 RPC 接 口 的 方式 直接 
查询 智能 合约 中 的 表 数 据 ， 这 样 更 加 适合 中 心 化 服务 灵活 配置 


自己 的 查询 需求 。 


查询 单条 数据 


USerlList::user index User_stabje(_seJlLf，_code,Vvalu 


user_stable,.find(id)， /根据 主 键 查询 数据 


查询 多 条 数据 


USerlList::user index User_stabje(_seJlLf，_code,VvaJlu 
auto agelindex = USser_stable,.get_index<"byage”n>() 
auto Itr = agelindex.find(20) 
whlile(itr != agelindex,end() ) 攻 


//Lprint 
】} 


以 上 示例 为 通过 二 级 索引 方式 对 年 龄 字段 进行 数据 得 询 ， 即 碍 
询 所 有 年 龄 为 20 的 用 户 列表 。 


小 结 本 章节 我 们 通过 代码 示例 的 形式 向 大 家 讲解 了 一 个 基础 
数据 功能 所 需 地 技术 知识 点 ， 以 及 如 何 分 步 桑 实现 一 个 具备 增 
删改 查 功 能 的 业务 模块 。 除 此 之 外 ， 还 重点 讲解 了 如 何 对 业务 
数据 的 多 维度 查询 检索 与 过 历 。 


在 教程 中 ， 如 采 出 现 钞 旋 或 不 易 理解 的 知识 点 ， 欢 迎 加 
我 微 信 指正 ! Name: zhangliang | WeChat: rushking2009 | 
Mall: zhangliang@cldy.org 


changelog 2019-03-08 
zhangliang(mallto:zhangliang@cldy.org) 


。 初次 发 称 


11.12 剖析 EOS 合 约 ABi 文 件 结构 


相信 不 少 开 发 者 朋友 在 进行 EOS 合 约 开发 时 ， 都 看 到 发 布 智能 
合约 时 的 ABI 文 件 。 那 ABI 文 件 到 底 是 什么 东西 ? 在 EOS 公 链 
环境 中 到 底 发 挥 怎 么 样 的 作用 呢 以 及 如 何 解 读 ABI 文 件 内 容 
呢 ? 


那么 本 草 下 将 市 你 了 解 ABI 文 件 与 智能 合约 间 的 关系 以 及 了 解 
并 学 会 ABI 文 件 的 编写 。 


ABI， 简称 (Application Binary Interface), 是 一 个 基于 JSON 语 
言 的 接口 描述 文档 ， 用 于 描述 EOS 合 约 以 及 如 何 对 合约 方法 进 
行 调用 。 如 果 大 家 曾经 接触 过 websocket、avro、hession、 
thrift 等 这 类 技术 的 化 ， 那 么 是 大 体 逻 辑 是 相同 的 。 比 如 
websocket 所 提供 的 wsdl 其 实 也 是 对 websocket 本 身 对 外 所 提 
供 服务 的 接口 描述 。 


在 EOS 合 约 ，ABI 文 件 是 由 开发 组 件 eosio.cdt 工 具 包 中 的 
eosio-cpp 命 令 执行 所 生成 的 文件 。 但 在 实际 开发 时 ， 时 策 会 
倍 到 一 些 情况 无 法 生成 ABI 文 件 。 因 为 在 合约 开发 ， 我 们 往往 
会 根据 业务 目 定 义 一 些 数 据 结构 ， 或 者 使 用 一 些 第 三 方 方 法 ， 
而 eosio.cdt 本 号 对 所 有 特 隆 并 不 是 文 持 的 很 完善 ， 所 以 时 常 导 
致 编译 失败 ， 这 时 就 需要 我 们 理解 ABI 是 如 何 定义 智能 合约 
的 ， 以 便于 我 们 定制 化 修改 自己 的 合约 描述 。 


ABI 文 件 结构 是 由 什么 组 成 的 呢 ? 让 我 们 和 看 一 个 示例 
| 


"Verslion"”: "eoSslo::ablI/X1L.0”， 
EVDpes 

SEEUIGCSa IN 区 

JEioOoiSw el 则 车 

"tables"”: []， 


"ricardian_ clauses"”: []， 
"abl_ extenslions"”: []， 
轴 Comment” : 


】 
上 面 json 示 例 展 示 了 一 个 标准 智能 合约 所 应 具备 的 完整 属性 定 
了 


数据 类 型 (type) 


在 项 目 开发 过 程 ， 有 时 为 了 便于 代码 的 理解 ， 我 们 会 将 一 些 通 
用 数据 类 型 或 数据 结构 进行 别名 定义 ， 用 一 个 在 业务 场景 中 更 
加 贴 合 业务 的 名 称 代替 。 在 types 数 组 中 便 是 对 这 种 情况 的 定 
义 描述 。 


比如 : 
{ 
"new_type_name": "age 
"十 ype” Te 
} 
或 者 
{ 
"new_type_name": "name"， 


"type": "string"” // 此 处 user 为 自 定 义 数据 结构 
了 


对 于 合约 内 骨 类 型 ， 是 不 会 在 此 展示 的 。 诸 如 : uint64 t、 
name、asset、symbol 等 。 下 图 展示 了 EOS 合 约 所 文 持 的 所 
有 内 置 数据 类 型 


buIitt_in types.empLace(t"b00L"， pack_unpack<uint8B _t>f1)); 
buitt_in types.emplace("int8"， pack_unpack<int8_t>{()); 
buitt_in types.emplace("uint8"， pack_unpack<uint8a_t>f)); 
buitt_in_ types.emplace("int16"， pack_unpack<int16 ft>()); 
buitt_in types.emplLace("uUint16"， pack_unpack<uint16_t>()); 
buitt_in_types.emplace{"int32"， pack_unpack<int32 ft>()); 
buitt_in types.emplace("uint32"， pack_unpack<uint32_t>()); 
buitt_in_types.emplace{"int64"， pack_unpack<int54 ft>()); 
buitt_in types.empLace("uint64"， pack_unpack<uint64 ft>()); 
buitt_in types.emplace("int128"， pack_unpack<int128_t>()); 
buitt_in types.emplace("uint128"， pack_unpack<uint128_t>()); 
buitt_in types.emplace("varint32， pack_unpack<fc::signed_int>()); 
buitt_in_types.emplace("varuint32"， pack_unpack<fc::unsigned_int>{)); 


// T0D0: Add proper Support for floating point types。For now this is good enough 


buitt_in _ types.emp1lace("ftoat32"， pack_unpack<flLoat>()); 

buitt_in types.emplLace("ftLoat64"， pack_unpack<doublLe>{)); 

buitt_in_ types.emplace("fLoat128”， pack_unpack<uint128_t>{()); 
buitt_in_ types.emplace("time _ point'"， pack_unpack<fc: :time _ point>()); 
buitt_in types.emplace("time point_sec"， pack_unpack<fcl::time point_sec>()); 
buitt_in_types.emplace("btock timestamp_type"， pack_unpack<btock_timestamp_type>{ )); 
buitt_in _ types.emplLace("name'， pack_unpack<name>()); 
buitt_in_types.emplace{"bytes"， pack_unpack<bytes>()); 

buitt_in types.emplace("string'"， pack_unpack<string>{)); 

buitt_in types.emplace("checksum1609"， pack_unpack<checksum160_type>{)); 
buitt_in_types.emplace("checksum256"， pack_unpack<checksum256_type>()); 
buitt_in types.emplace("checksum512"， pack_unpack<checksum512_type>({)); 
buitt_in _ types.emplace("pubLic_key"， pack_unpack<pubtic_key_type>()); 
buitt_in_types.emplace("signature'， pack_unpack<signature_type>()); 
buitt_in_types.emplace{("Ssymbot'， pack_unpack<symboL>{)); 

buitt_in types.emplace("symboL_ code"， pack_unpack<symboL_ code>()); 
buitt_in_types.emplace("asset'， pack_unpack<asset>()); 


buitt_in _ types.emplace("extended asset"， pack_unpack<extended asset>()); 


结构 体 (struct) 在 业务 处 理 逻 辑 中 ， 为 了 方便 数据 的 传输 与 调 
用 ， 往 往 我 们 会 对 针对 业务 数据 进行 建 模 并 以 结构 体 的 形式 展 
现 。 同 样 ， 它 也 需要 在 ABI 文 件 中 进行 描述 。 

比如 : eosio.token 合 约 中 的 account 结 构 体 定义 


。ABI 文 件 定义 
| 
"name": ”account "， 
"base"”: ””， 
人 edsensa 
1 
"name": "balance'"， 
"十 Xpe"”: "asSsset” 
] 


。eosio.token.hpp 实 现 


Struct account 1 
asSsset balance ， 


Uint64 t primary_key()const 1 
return balance,symbol.code().raw() ，; 
1 
了 


另外 ， 需 要 注意 的 吏 是 除了 以 上 这 种 结构 体 定 义 ， 其 实 还 存在 
一 种 隐 性 结构 体 ， 即 : 合约 方法 参数 示例 : 


。eosio.token.hpp 中 transfer 方 法 定义 


vold transfer( name from， 
name to ， 
asSset duUantity， 
String memo )， 


。eosin.token 合 约 中 transfer 方 法 在 ABI 文 件 中 定义 


"name"”: "transfer”， 
"base": ”"”， 
reiliclsinnt sa 
世 
"name"”: "和牛 rom"”， 
" 革 ype"”: ”name” 
j， 
L 
"name": "to"”， 
"十 yxpe"”: ”name” 
j， 
| 
"name"”: "quantIty”， 
"type"”: "asset"” 
j， 
| 
"name"”: "memo"， 
"type"”: " String” 
) 
] 
】} 


可 以 看 出 ， 隐 性 结构 体 与 前 面 所 定义 显 性 结构 体 定 义 是 并 没有 
什么 不 同 ， 只 是 在 和 能 合约 业务 逻辑 中 ， 我 们 仅 用 到 显 性 结构 


体 来 存储 我 们 的 业务 数据 进行 远 辑 判断 。 


方法 (Action) Action 数 组 主要 用 于 描述 外 部 可 调用 的 方法 列 
表 以 及 具体 的 参数 列表 。 在 智能 合约 中 ， 如 果 需 要 对 外 公开 合 
约 方法 ， 往 往 会 在 合约 头 文件 中 进行 如 下 定义 : 


[Leosio::actionj]j 
vold transfer(Cname from,name to，asset dgquant1iIty， S 


而 ABI 的 表现 形式 为 : 

{ 
"name"”: "transfer"”， 
"type"”: transfer "”， 


"rIcardlIan _ contract": "" 


】} 


从 上 述 描述 可 以 看 出 ， 在 方法 的 类 型 定义 关联 了 前 面 的 隐 性 结 
构 体 类 型 。 虽 然 在 此 处 ， 方 法 名 与 隐 性 结构 体 类 型 命名 一 致 ， 
但 实际 情况 并 不 一 定 非 要 相同 。 


表 定 义 (Table) 


关于 表 的 ABI 定 义 ， 相 比 其 他 几 种 定义 要 稍 复杂 一 些 。 上 有 具体 
JSON 定 义 如 下 


1 
"name" ， 二 网 
"type TIT TI 
"Index_ type”: "””， 


"key_names"” : 上 []， 


】} 


“key_types”  : [ 


JSON 中 字段 说 明 如 下 : 


nanme 


合约 初始 化 表 时 所 要 使 用 的 名 称 
type 
表 对 应 的 数据 结构 体 。 也 束 是 前 面 所 说 的 显 性 结构 体 类 型 


Index _type 

此 类 型 为 表 主 键 类 型 

key _names 

索引 字段 列表 

key types 

索引 字段 数据 类 型 列表 。 数 据 长 度 与 索引 字段 列表 长 度 一 
致 。 需 要 说 明 的 是 索引 字段 类 型 ， 只 文 持 uint64_tuint128 
_tuint256 tdouble,long double 五 种 类 型 示例 : 
eosio.token 合 约 中 的 accounts 表 


ABI 表 定义 
{ 
"name"”: "accounts'"， 
"十 Xpe"”: ”account ”， 


"Index_type": ”164"， 
"key_names"”: [ primary_ key "|]， 
"key_types"”: [uint64”] 


表 合 约 代 码 


struct [[eosio::table]j] account 1{ 
asSsset balance ， 


IITn+A4 + nrimarwv kewvNMrnncs+ ref+rrn halanrt 


wa 一 下 二 | 下 生 一 LISA T SA 人 和 / ww AT 二 本 1 ww 1 NA AL L LE IE NAN 


从 表 合 约 代码 可 以 看 来 ， 只 需要 在 数据 结构 体 代 码 中 添 加 
eosio-table 标 签 承 可 以 完成 对 表 的 定义 操作 。 
之 所 以 提供 多 索引 的 实现 ， 主 要 还 是 为 了 应 对 业务 场景 中 不 同 
维度 的 数据 得 询 ， 而 且 文 持 按 升序 或 降序 的 远 历 方式 处 理 业 


ricardian 条 款 (ricardian_clauses) 该 数组 主要 用 于 定义 一 种 
基于 文本 的 合约 宪法 。 通 过 其 与 智能 合约 的 整合 ， 来 解决 一 些 
无 法 通过 程序 来 判定 的 情况 。 


示例 如 下 : 
"ricardlian clauses”: [{ 
ODAS ES 
"body”: ”WARRANTY ，The invoker of the contra 


了 
"Id": "Defau]lt"， 
"body”: "DEFAULT ，The occurrence of any of 坏 
“Id : "Remedles ， 
"body”: ”REMEDIES， In addition to any and al 
1 
] 


我 们 可 以 针对 智能 合约 或 者 具体 的 合约 方法 ， 附 加 上 对 应 的 文 
本 合约 描述 。 比 如 针对 方法 的 文本 合约 定义 : 


。ABI 定 义 


0 二 r~+Timnmncn' 了 


Scan 
"name'" ， 二 
"十 Xpe ”: 和 间 革 本 
"rilcardian_ contract": "# CONTRACT FOR hel1]o 
1 


。 代码 及 文件 定义 〈hello.hi_rc.md) 
## CONTRACT FOR _ hello: :hi 
## ACTION NAME: hi 


####_ Parameters 
Input parameters : 


*“  _ User (String to Include In the output ) 
ImpJlied parameters: 
* “ account_name ” (name of the party Invoking an 


##### Intent 
INTENT ， The IntentiIon of the author and the InvV' 


#### Term 


TERM，This Contract expires at the conclusion 0; 


ABI Extensions 该 功能 将 允许 用 户 进行 目 定 义 区 块 扩 展 ， 包 
括 对 数据 的 签名 、 编 码 等 。 不 过 现在 该 属性 暂 未 被 应 用 支持 。 


到 此 ， 相 信 大 家 对 于 整个 ABI 文 件 的 结构 应 该 有 了 大 体 的 认识 
与 理解 。 这 样 大 家 可 以 在 研究 其 他 智能 合约 时 ， 可 以 首先 阅读 
对 方 的 ABI 文 件 ， 束 可 以 熟悉 对 方 的 整体 接口 框架 。 


在 教程 中 如 出 现 错误 或 不 易 理 解 的 知识 点 ， 欢 迎 加 我 微 信 
指正 ! Name: zhangliang | WeChat: rushking2009 | Malil: 
zhangliang@Qcldy.org 
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下 动手 实践 集成 七 核心 组 件 的 完整 Node 
放 


动手 实践 集成 七 核心 组 件 的 完整 Node 工 程 


本 文 将 带领 大 家 从 空 项 目 开 始 ， 在 NodeExpress 框 架 基 础 上 ， 逐 个 
集成 以 下 组 件 : 多 配置 切换 、Http 组 件 、Socket 组 件 、 日 志 组 

件 、mysdqypool、 日 志 组 件 、 调 度 组 件 等 ， 并 在 后 续 项 目 业 务 开发 
环境 中 帮助 解决 对 应 的 技术 问题 。 

通过 整个 集成 过 程 ， 你 可 以 了 解 整个 集成 过 程 流程 ， 而 且 能 够 熟悉 
与 了 解 所 有 组 件 的 具体 用 法 及 使 用 场景 ， 还 可 以 总 结 在 项 目 过 程 中 
可 能 遇 到 的 各 种 问题 。 


在 搭建 项 目 开始 之 前 ， 请 先 确保 本 地 已 经 安装 Node 服 务 。 
一 、 新 建 工 程 目录 
在 本 地 新 建 一 个 目录 文件 夹 


> mkdir mysideproj 
> cd mysideproj 


执行 npm init 命 令 ， 对 项 目 进行 配置 初始 化 
mySsideproject> npm init 


竺 命令 交互 窗口 ， 一 路 回 车 ， 待 命令 执行 完成 后 ， 会 在 本 地 目录 中 
生成 一 个 package.json 文 件 。 


//Lfile: package,.json 
"name": "myslideproject ”"， 
"Verslon": "1.0.0"， 


"description"”: "this 1s my first Slideproject .,…， 
"maln”": "Index.]js …， 


SGi3 Di 蕊 SS 


"test"”: "echo AN Error : 
人 
LOiT 
"icense": "ISC"” 


此 时 ， 项 目 目 永 结构 如 下 : 


一 node_modules 


| 一 package-lock,json 


-一 package,. json 


二 、 安 装 与 集成 EXxpress 


在 命令 窗口 ， 执 行 express 组 件 安 # 


no _ test Specified\"”&& exit 


小 E 人 ~- 
用 且 


mySsideproject> npm _ install expressQ4.15.2 


+ expressQ4.15.2 


然后 ， 在 本 地 目录 ， 新 建 系统 入 口 文件 index.js 


mySsideproject> touch index., js 


编辑 jindex.js 文 件 ， 添 加 如 下 代 人 三 


Var express = reduire( express - ) 


Var app = express'( ) 


appg de 人 Gaecd 


Re 区 = 下 


res.Send( 'This ls my first Sideproject1  ) 


]}) 


app.L isten(3000，function () 1{ 
conSsole,1og( ']istening on *:3000 ' ) 


， 
局 动 项 目 程 序 


mySsideproject> node index,js 
Listening on *:3000 


显示 listening on *:3000， 则 意味 着 服务 启动 成 功 。 打 开 浏 览 露 ， 
访问 http:/localhost:3000 
四 局 和 外 门 localhost:3000 Xx 耳 二 


所 C 合 @ localhost:3000 


This is Imy7 first sideproject! 


三 、 安 装 与 集成 Http 服 务 

在 实际 业务 场景 中 ， 往 往 我 们 都 需要 为 不 同业 务 模块 提供 一 系统 的 
数据 查询 及 存储 接口 ， 而 且 接 口 间 交 易 也 普遍 使 用 son 格 式 进 行 数 
据 交 互 。 

那么 ， 接 下 来 将 会 对 Express 进 行 http 及 json 解 析 配 置 ， 并 且 文 持 丰 
富 的 路 由 功能 。 


安装 依赖 组 件 


。 body-parser@ 1.18.3 
该 组 件 主要 用 于 对 http 请 求 参数 进行 解析 处 理 


mysideproject> npm install body-parseQ1.18.3 


集成 步骤 
1. 在 文件 头 中 引入 body-parser 件 


var bodyParser = require(" body-parser ”) ， 
2. 配置 header 参 数 ， 解决 前 端 请 求 路 域 问题 


app,all1( - ，function (redqd，res，next) ({ 
res.header( 'Access-Control-ALLow-Oorigin ， * ) 
res,header( 'AcceSss-ControlL-ALLIow-Headers ， Con 
res,header( .Access-ControlL-AJJLIow-Methods ， "PUT 


if (redq.method == ' OPTIONS ' ) 1{ 
res,Send(200 ) ， 

} else { 
next( ) ， 


人 


3. 使 用 body-parser 组 件 解 决 请 求 参 数 


app.uUse(bodyParser,UuUrlencoded({ 
extended: false 


于 


app.uUse(bodyParser ,json() ) ; 


4. 定义 路 由 规则 及 错误 响应 


var router = expreSss.Router () 
//T0D0 实现 目 定义 http 接 口 
app,use( / ，router ) ， 


针对 网 站 啊 应 400 等 异常 信息 ， 预 先 定 义 异 常 啊 应 信息 


app.uUse(function (req，res，next) 革 
res,Status(404).Ssend("Sorry，that route doesn ' 芋 


3 风 


5. 初始 化 http 服 务 并 设置 监听 端口 


Var http = _ require( ' http').Server(app) 
http. isten(3000，Tfunction () { 
console.1Log('`]istening on :3000  ) 


3 
编写 示例 接口 
编写 一 个 测试 服务 接口 ， 比 如 : /v1luser?name=hackdappexch 


//e,.g http:// localhost:3000/v1/user?name=hackdappexcnh 


router ,get(' /vv1L/user ' ，function (red，res) 并 
Jet name = redqd,.query.name 


res.SetHeader( ' Content -Type ， ' application/json  ) 
res, json(L{ 


SocUSnO 攻 se 
"data": "hiI，"”+ name 
了 ) 
9 


req.query.name 为 获取 当前 链接 中 name 参 数 ，res.json 方 法 则 是 


用 以 json 格 式 响 应 数据 结果 。 
效果 演示 
启动 项 目 工程 


node Index.]js 


打开 浏览 器 , 访问 http:/localhost:3000/v1/user? 
name=hackdappexch 


人 四 @ 品 localhost:3000/v1user?name- X 十 


扣 C 合 (Oliocalhost:3000Nv1/user?zname=hackdappexch 

1 // 20190322160427 

2 // http ://LocaLhost :3000/v1/user?name=hackdappexch 
3 

4 v 1{ 

5 “atUS 3 “ 虹 ， 

6 "data": “hi，hackdapPpexch” 

7 } 


采 能 正 滑 显示 上 图 结果 ， 则 表明 猛 证 成 功 。 
到 此 , Node 项 目的 Http 服 务 配置 完成 。 
完整 代码 

Var express = reduire( express  ) 


Var app = express'( ) 
Var bodyParser = reduire("body-parser ”) 


app.alJl1('*'"，function (req，res，next) { 
res.header( 'Access-Control-AlLlow-origin '， 


0 


如 


res,header( .Access-ControlL-ALLow-Headers ， Content - 
res,header( .Access-ControlL-ALLow-Methods ， PUT， POS 


if (redq.method == : OPTIONS ) 革 
res,Send(200) 

} else { 
next'( ) 

】} 


app.Use(bodyParser,UuUrlencoded ({ 
extended: false 


罗 
app.uUse(bodyParser ,json() ) 


Var router = express,Router() 
router .get( /v1L/Vuser ，function (red，res) 革 
Jet name = redq,.query.name 


res,SetHeader( Content -Type"， 'applLication/json  ) 
res, json(L{ 
SEEaEUSOEEOLKe 
"data": "hiI，”+ name 
和 
了 ) 


app.uUse( /'，router ) 


app.uUse(function (req，res，next) { 
res,Status(404).Ssend("Sorry，that route doesn't ex 


]}) 


Var http = _ require( http ),Server(app) ， 
http. isten(3000，Tfunction () { 
console.1Log( ']istening on ”*:3000 ' ) 


局 


四 、 安 装 与 集成 socket.io 组 件 


需求 场景 在 交易 所 K 线 图 业务 场景 中 ， 往 往 需要 实时 的 对 成 交 数 据 
进行 快速 的 报表 数据 展示 。Http 接 口 在 每 次 请 求 之 后 都 需要 重新 进 
行 连 接 ， 相 较 于 socket 长 连接 而 言 ， 数 据 及 时 性 要 老 一 些 。 另 外 一 
下 征 采 用 http 方 式 ， 后 端 程 序 无 法 异步 推送 消息 数据 给 前 端 
页 


组 件 依 赖 


e。 SOCKket.I0 
socket.io 是 一 个 在 浏 跑 回 端 与 服务 器 端 之 间 实 现 基于 事件 的 实 
时 双 回 服务 组 件 。 


Slideproj> npm Instal]l socket .1I0oQ01.7.3 


集成 步骤 
1. 安装 socket.io 组 件 


Slideproj> npm Instal]l socket .1I0oQ01.7.3 


2. 注册 socket 服 务 
编辑 index.js 文 件 ， 添 加 以 下 代码 


Var http = _ require( ' http'").Server(app) 
Var Socketsvr = reduire( ' socket ,1o' )(http ) 


3. 注册 socket 请 求 事 件 


o _ Connection 


系统 事件 ， 当 有 新 客户 端 连接 到 服务 器 后 触发 此 事件 。 


SocketSsvr ,on( :connection'， function (Socket ) 并 


} 


o disconnect 


系统 事件 ， 当 客户 端 断 开 连接 后 ， 会 触发 此 事件 。 


SocketSsvr ,on( 'disconnect '，Tfunction (Socket ) 革 
//Ltodo do Some Stuff 


。 目 定 义 事 件 
开发 人 员 可 上 自 定 义 事件 及 其 参数 


socket ,on(< 目 定义 事件 >，function(args) { 
//todo do some Stuff 


注 : 以 上 代码 需 在 系统 事件 connection 方 法 中 定义 ， 也 就 是 
需要 将 事件 监听 到 具体 的 连接 客户 端 上 。 


4. 注册 socket 员 应 事件 
啊 应 事件 主要 用 于 向 客户 端 发 送 革 一 事件 的 消息 数据 


e 吊 应 单个 客户 端 
socket ,emit(< 目 定义 事件 >，{ <key>: <Value> 
】} 


注 : 需要 事先 存储 该 客户 闪 连 接 实 例 


o 广播 啊 应 
问 所 有 连接 到 服务 右 客 户 端 基于 某 一 事件 进行 消 上 广 播 


socketsvr ,emit(< 目 定义 事件 >，{ <key>: <vValue> 


注 : emit 锌 调用 的 实例 为 服务 器 socket 实 例 
编写 示例 


1. 编写 监听 事件 


SocKeLSvr .on('connectlon'， TunctlLon (SoOCcKeL) 1 
Socket.on(' kJline.query ，function(args) 荆 
conSsoJle,. Jog(Cargs ) 
9 


2. 编写 响应 事件 
//L， 单 客户 啊 应 事件 


SocketSsvr ,on( connection' ， function (socket ) 1{ 
conSsole,.Jog(Cargs ) 


Socket.on(' kJline.query ，function(args) 革 


Socket .emit( :kJline.resujlt ，({ 
"Status': "OK'， 
msg : "this is a normal message， durat 
人 
3 


//2， 广播 事件 
SocketSsvr .emit( :price,Uupdate ' ，({ 
SatuUsn ioOks 
"msg : this 1Is aa boardcast message , 


人 


示例 效果 


测试 工具 :Socket,io tester | Apps | Electron 


完整 代码 


Var express = require( 'express ' ) 

Var app = express( ) 

Var http = _ require( ' http').Server(app) 
Var Socketsvr = redquire('socket .1o')(http) 
var bodyParser = redqduire("body-parser'"”) 


app.all1('*'"，function (req，res，next) { 
res.header( 'Access-Control-ALJLow-Oorigin'， "* ") 
res,.header( 'Access-ControlL-ALlLow-Headers' ， "Content - 
res.header('Access-Control-ALLow-Methods'， "PUT， poa 


if (req,method == ' OPTIONS ' ) { 
res.Send(200) 
} else 《 


next'( ) 


1 
志 


app.uUse(bodyParser,UuUrlencoded ({ 
extended: false 


9 
app.uUse(bodyParser ,json() ) 


Var router = express,.Router ( ) 
app.USse( /'，router ) 


app.uUse(function (req，res，next) { 
res,Status(404).Ssend("Sorry，that route doesn't ex 
和 
router ,get('/Vv1L/user ' ，function (red，res) 并 
Jet name = redqd,.query.name 


res,SetHeader( Content -Type"， 'applLication/Zjson  ) 
res, json(L{ 

"StatuS": "OKk'"， 

data 二 放 ame 
了 ) 


SocketSvr .on( :connection ' ， function (Socket ) 革 
Socket.on(' kJline.query ，function(args) 
socket .emit( :kJline.resulLt ， 
"Status': "OKk'， 
msdg : "this is a normal message，duratior 
2 

局 
772) 播 事件 


SetIntervalL(function(Svr)({ 


Svr.emit(' price,.Uupdate ，1{ 
"Status': "OK'， 
msg :this Is a boardcast message ,” 


站 
站 ，5000，SocketSsvr ) 


http. Listen(3000，function () 
conSsole,1og( ']istenling on *:3000 ' ) 


史 


五 、 安 装 与 集成 Mysql 及 连接 池 


需求 场景 


使 用 连接 池 提 高 频繁 的 数据 库 连 接 操作 ， 从 而 查询 或 更 新 等 操作 的 
执行 速度 ; 


依赖 组 件 


。 mysequelQ 1.0.2 
。 mysdql2Q@ 1.1.0 
集成 步骤 
1. 安装 组 件 依赖 
npm instal]l1 mysedue1Q1.0.2 
npm install1 mysdq1L2Q@1.1.0 


2. 引入 组 件 
const mysedqduel = _ require( ' mysedqueJl  ) 


3. 准备 mysdl 数 据 库 信息 


o 数据 库 地 址 ; 127.0.0.1:3306 
o 数据 库 名 称 : mydb 
o 用 户 名 : root 


o 密码 : 


4. 实例 化 连接 池 


Let mysdqlLl = myseduel(L{ 


ABRSIE 0 

[olGilRlee 3306 

"USer ”: 人 人 Oil 
DassWorge <bpwo> 
"database": "<mydb>"” 
"Charset": "utf8_ general_ ci” 


] ) 
5. 配置 实例 监听 事件 


this.mysdqlLl.on( 'dquery-complete'"，(type，dquery，durat 
/MLtodo do Some Stuff 
了 ) 


this.mysdqlL.on( 'dquery-error '，(err，type，dquery，dur 
/MLtodo do Some Stuff 
3 


6. 连接 池 对 象 方法 
o A、 添 加 


this.mysdqlL.dqueryInsert(SsSqL，[values]，[options ] )， 
该 方法 为 一 个 异步 调用 方法 ， 返 回 值 为 和 目 增 序列 id 

o B、 修 改 
this.mysdqlL.dqueryCchanged(sql，[values]，[options ] ) 
， 返 回 对 象 为 promise 且 执行 结果 为 更 新 成 功 的 条 数 

o C、 删 除 
this.mysdqlL.dqueryCchanged(sql，[values]，[options ] ) 
， 返 回 对 象 为 promise 且 执行 结果 为 删除 成 功 的 条 数 


o D、 查 询 
this.mysql.query(sqL，[values]，[Toptions]) ， 返 回 
ee 
this.mysql.queryRow(sqLl，[values]，[options])， 妈 
回 对 象 为 Promise 对 象 且 执行 结果 为 符合 条 件 的 所 有 数据 集 
列表 数据 的 首 行 数据 ; 
this.mysdqlL.dquerycellL(sdqL，[values]，[options]) ， 
返回 对 象 为 Promise 对 象 且 执 行 结果 为 : 符合 条 件 的 所 有 数 
据 集 列 表 数 据 的 首 行 数据 中 的 第 一 个 字段 数据 。 


* 所 有 sq 方法 都 支持 预 编译 的 方式 进行 数据 查询 或 更 新 等 操 
作 。 


更 多 方法 ， 可 参考 官方 文档 : mysequel - npm。 


编写 示例 
本 地 初始 化 数据 库 ， 并 执行 以 下 数据 表 创 建 脚 本 : 


SET NAMES Utf8mb4 ， 
SET FOREIGN_KEY_CHECKS = 0， 


DROP TABLE IF EXISTS “news ， 

CREATE TABLE news (人 
`“id ”bigint(20) NOT NULL AUTO_INCREMENT ， 
title ” varchar(255) COLLATE utf8mb4_ bin NOT NULL DE 
note ”varchar(255) COLLATE Utf8mb4_ bin NOT NULL DEF 
Createtime ” datetime NOT NULL， 
PRIMARY KEY ( `id ”) 

) ENGINE=InnoDB AUTO_INCREMENT=21 DEFAULT CHARSET=UtfT5 


-- _ Records of news 


BEGIN ， 
INSERT INTO “`news`” VALUES (20， ' 测 试 标 题 ' ， 备注 !'， 2018 
COMMIT， 


SET FOREIGN_KEY_CHECKS = 工 ， 


彤 写 mysqljs， 该 文件 用 于 根据 配置 的 数据 库 参 数 实 例 化 mysdl 对 


? 


var mysedquel = require( 'myseduel ) 


VailaEcC 人 Eg 下 三 王八 
2IeKSIE EdE27 并 0 汪 d 
iDOjRIEe XUS 


USser ': root '， 
"password ': "admin123 ， 
"database ': "test '， 


人 


Var mysqlL = mySsedqueL(Ccfd) 
mysdql.on( 'query-complLete '` ，(type，dquery，durat1ion) => 
conSole,1og("%s %s query compJleted In %d ms"，duer 


5 
mysdql.on( 'query-error '，(err，type，dquery，duration) := 
conSole,1og("%s %s query faliled after %d ms"，err， 


0 


module,.exports = mySsd1]， 


编写 news.js， 主 要 用 于 集中 实现 业务 逻辑 ; 


var mysql = reduire( ./mysq]l ) 


exports.findById = (Id) => mysdql.dqueryRow( ' SELECT ”* FF 


在 index.js 文 件 中 ， 集成 user_service.js， 对 外 提成 查询 服务 了 1) 
在 头 文 件 中 引入 news .js 


Var news = reduire( ,./Vnews  ) 
2) 添加 对 外 接口 服务 


router .get('/Vv1L/Znews ' ，async function (redq，res) { 
let ld = redq,query ,Id 


let result = awalt news .findById(iId ) 


res,SetHeader( Content -Type"， 'applLication/json  ) 
res, json(L{ 
"StatuSs": "OKk'"， 
"data": resuJ]t 
呵 
0 


效果 演示 


访问 浏览 器 http:/Wlocalhost:3000/v1Lnews?id=20， 执行 结果 如 
扣 C 合 @ localhost':3000vTynews?id=20 


{ 


Status:i "ok'"， 
- data: ({ 
za: 20， 


title: "测试 标题 " ， 
note: "备注 " ， 
Createtimne: "2018-06-13T19:49:04.0002" 


下 : 
完整 代码 


index.js 


Var express = reduire( ' express  ) 

Var app = express'( ) 

Var http = _ require( 'http"),Server(app) 
Var Socketsvr = reduire( socket .1Io' )(http) 
Var bodyParser = reduire("body-parser ”) 

Var news = reduire( ,./Vnews  ) 


app.all('* ”，function (req，res，next) { 
res,.header( 'AcceSsSs-ControlL-ALLow-origdin ， * ) 
res.header( 'Access-Control-ALlLow-Headers ， "Content - 
res,.header( 'AcceSss-ControlL-ALLow-Methods ， PUT， POS 


If (red.method == OPTIONS ) 1{ 
res,.Ssend(200) 

} else { 
next'( ) 


} 


app.uUse(bodyParser,UuUrlencoded ({ 
extended: false 
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app.uUse(bodyParser ,json() ) 


Var router = express.Router( ) 
app.Use( /'，router ) 


app.uUse(function (req，res，next) { 
res,Status(404).Ssend("Sorry，that route doesn't ex 
旺 
router .get(' /vv1L/user ' ，function (red，res) 并 
Jet name = redq,.query.name 


res,SetHeader( Content-Type"， 'applLication/json  ) 
res, json(L{ 

SECEaEUSOO OK 

EeeEIS 
电 


router .get('/Vv1L/Xnews ' ，async function (redq，res) { 
Let ld = redq,query,Id 


let resujlt = awalt news .findById(1Id ) 


res,SetHeader( ' content -Type'"， 'applLication/Zjson  ) 
res, json(L{ 
SEEaiEUSa OK 
"data": resuJ]t 
| 


SocketSvr ,on( ' connection ' ， function (Socket ) 并 
Socket.on(' kJline.query ，Tfunction(args) 
socket .emit( ':Kkline.resulLt ， 1 
"Status': "OK'， 
"msg :this is a normal message，duratior 
) 


昌 ) 
//2， 广 播 事件 


SetInterval(function(svr){ 
Svr.emit( - price.update ，({ 
SEEUELUIS AH Yoiic 
msg : "this 1Is aa boardcast message ,” 


，5000，SocketSsvr ) 


http. Listen(3000，function () 
conSole,.1og( ']istenling on *:3000 ' ) 


六 、 安 装 与 集成 多 配置 


业务 场景 

在 应 用 系统 的 整个 开发 周期 来 讲 ， 都 会 面临 开发 、 测 试 、 模 拟 环 

境 、 正 式 环 境 等 多 个 环境 的 部 署 及 功能 测试 ， 因 为 每 个 环境 所 需要 
的 参数 都 不 相同 。 而 面 对 这 样 的 场景 ， 我 们 束 可 以 使 用 多 配置 参数 
文件 ， 根 据 不 同 的 环境 切换 到 不 同 的 参数 配置 上 即 可 ， 方 便 产 品 环 
境 的 快速 化 部 获 。 


安装 依赖 组 件 
e。 nconf@Q0.10.0 


。jS-yamlQ@3.12.0 


npm install nconfQ@0 .10.0 
npm install js-yam103.12.0 


关于 配置 文件 的 格式 其 实 有 很 多 种 ， 比 如 : json、xml、toml、yaml 
等 等 。 但 在 此 教程 中 将 介绍 的 是 如 何 集成 yaml 格 式 文 件 配置 。 


集成 步骤 


定义 多 个 配置 文件 〈devtestsimulationprod ) 


常规 情况 下 ， 往 往 都 会 配置 三 类 环境 参数 文件 : 本 地 开发 、 测 试 环 
境 、 正 式 环 境 ， 所 以 分 别 定 义 三 个 文件 : app.dev.yaml、 
app.test.yaml、app.prod.yaml|， 


三 个 文件 的 内 容 均 为 以 下 格式 ， 只 是 配置 参数 有 所 不 同 。 


app : 
Server : 
port: 3000 
db : 
mySsq]: 
osiEea 之 MOROR|n 
port: 3306 
USer: test， 
password: ' admin123， 
database: "test 
charset: 'Utf8_general ci， 


定义 config.js 
创建 config.js 文 件 ， 引 入 nconf、fs、js-yam1 三 个 包 
const nconf = require("nconf'”) 


const fs = redqduire(" fs- ) 
const yam1L = reduire( js-yam]  ) 


令 运行 参数 配置 ， 缺 省 使 用 dev 配 置 


读 取 命令 
dev， 


nconf .argv().env()， 
const env = process.env,.NODE_ENV | | 
读 取 并 解析 配置 文件 

Var flilepath = "SrcVvconfigXapp. ”+ env + " ,Yam]” 


if (!fs.existsSync()) ({ 
throw 
name: "FlIlLeNotFoundEXxception'" 

message: "UnabJle to find configFiIlLe ”+ fileps 


了 ; 
nconf .file({ 
file: filepath， 


format : 二 
parse: yam1L.SafeLoad ， 
Stringify: yaml1.SsafeDump， 


六 
读 取 nconf 对 象 实例 ， 获 取 参 数 定 义 
， 引 


nconf .get() 


重 构 代 码 ， 提 取 配 置 参 数 至 配置 文件 中 
比如 : 服务 局 动 端口 地 址 ;数据库 配置 参数 等 。 在 index.js 中 


入 配置 文件 config,js 
redqulire(- ,/Vvconfig  ) ， 


Var config 
琵 换 服务 名 局 动 端口 地 址 


http. Listen(config,app.Server.port，Tfunction () 二 
console.1og('`]istening on *:%s'，config.app.Sserver 


修改 mysqljs 文件 ， 替 换 mydl 参 数 配 置 ， 


Var mysequel = reduire( mysedqdueJ ) 
var config = reduire( ,./vconfig ) ,oad () 


var mysqlLl = mysedueJL(Cconfig,.app,.db.mysq]) ， 

mysdql,.on( 'query-complLete '` ，(type，dquery，durat1ion) => 
conSoJle,1og("%s %s query compJleted In %d ms"，duer 
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mysdql.on( 'query-error '，(err，type，dquery，duration) := 
conSole,1og("%s %s query faliled after %d ms"，err， 


和 


module.exports = mySsd1， 


效果 演示 
可 目 行 修改 相关 环境 配置 参数 进行 验证 。 


七 、 安 装 与 集成 日 志 组 件 


在 日 单 开 发 过 程 ， 尤 其 是 在 线 上 环境 ， 我 们 往往 需要 回 漳 之 前 的 日 
志 信 息 进 行 问 题 跟踪 ， 这 样 吏 需 要 一 个 实时 记录 线 上 关键 结 点 记录 
的 组 件 --- 日 志 框 淋 。 


按照 符合 贡 规 项 目的 有 要求 ， 日 志 框 巢 往往 需要 文 持 以 下 几 个 功能 


。 按 不 同 级 别 进行 日 志 记 录 。 比 如 : debug、info、warn、error 
。 支 持 按 文件 、 控 制 台 、logstash 进 行 日 志 打印 
。 文 持 按 天 或 按 大 小 进行 日 志 压 缩 与 切割 


安装 依赖 组 件 


。 Winston@3.1.0 
s。 Winston-daily-rotate-fle@3.5.1 


npm install winstonQ@3.1.0 
npm instal]l winston-daily-rotate-fileQ3.5.1 


集成 步骤 
引入 组 件 包 


const { createLogger，format，transports } = redqulire(， 
const { combine，timestamp，] abel，printf } = format 
const path = reduire(' path )， 

const fs = redquire( ' fs')， 

reduire( winston-daily-rotate-file ' )， 


日 志 格 式 化 配置 


format: combine( 
abeJ({ 
abe1 : 'dexchange#' + path.basename(modu]e， 
| 间 克 
format ,.SplLat()， 
format .coJLJorlIze()， 
timestamp(({ 
format: "YYYY-MM-DD HH:mm:ss， 
| 交 克 
printf(info => 1{ 
Let msdgd = Info.message 
这 
If (Info,message Instanceof Object ) { 
msg = JSON.Sstringify(info.message ) ， 


1 


} catch (error) 
msg = info.messagde， 


return  ${finfo,timestamp}+ [$ftinfo,abel}] $tir 


label 为 日 志 前 缀 标签 ，printf 方 法 主要 用 于 定义 日 志和 格式 排版 以 及 


对 格式 化 日 志 参 数 对 象 。 
日 志 级 别 及 切割 


transports: [ 
new transports,.Console(L{ 
leve1: < 日 志 级 别 > 

有 

new(transports.DalJyRotateF1lIle)(L{ 
leve1: < 日 志 级 别 >， 
filename : 人 < 日 志 名 称 > ) ， 
daEEPSEEETTE 同志 作 直 于 
zippedArchive; < 日 志 压 缩 >， 
maxSize: < 切割 文件 大 小 >， 


maxFiles:; < 文件 保留 天 数 > 
】 ) 


日 志 组 件 类 loggerjs 


const { createLogger，format，transports } = redqulire(， 
const { combine，timestamp，Jabel1，printf } = format 


const path = reduire( path  ) 
const fs = reqduirel( 'fs') 
reduire( ' winston-daily-rotate-fijle') 


Let confidgd = redqdulire( ,/Vvconf1ig ' ), Load () 


exports.createLogger = () => { 
RESRexsessyneekodgsnog 朋 本 攻 
fs,.mkdirSync( ' 1ogs  ) 
1 


return createLogger({ 
format: combine( 


abeJ({ 
abel1] : “dexchange#' + path.basename (n 


站 汉 且 
format .,SplLat()， 
format .coJLorlIze()， 
timestamp(({ 
format: "YYYY-MM-DD HH:mm:ss， 
从 汉 夺 
printf(info => 区 
let msd = Info.messade 
[加 RAR 
If (Info,.messagde Instanceof Object ) 
msdq = JSON,.Sstringify(Info.messac 
了 
} catch (error) { 
msd = Info,.message 
return “${info.timestamp} [${tinfo ,abe]】 
) 
) ， 
transports: [ 
new transports.Console({ 
JeveJ]: config.app,ogger,console. Level 


站 


new(transports,.DalJlLyRotateFlile)(L{ 
Leve]l: config,.app. logger.file. eveLl， 
fiIlename: path,., join(' 1]ogs'-" ，config.ap[ 
datePattern: config,app.Logger.file.ds 
ZippedArchive: config.app. Logger.file， 
maxSize: config.app. Logger.file.maxSsiz 
maxFliles: config.app,logger.file.maxFaj 


]}) 
思 


重 构 工 程 源码 
将 之 前 使 用 console.log 替 换 为 loggerinfo 方 法 


编写 示例 

引用 日 志 组 件 

var ogger = reduire( '`./ Logger ' ),.createLogger() ， 
打印 日 志 


Logger .Info( ' Hello again distributed Logs ) ， 
Logger .infol( hello ，{ 人 message: "wor1d” 上) ， 


// info: test message my String 1{} 
1ogger .Log('` info ， test message %s ， :my String  ) ， 


// info: test message 123 1{} 
Logger .Log( ' Info'`， "test message %d'" ，123) ， 


// info: test message first second {fnumber: 123} 
Logger .Logd( ' info'， "test message %Ss，%S'， ' first'"， "Se 


效果 演示 


八 、 安 装 与 集成 eosjs 
安装 依赖 组 件 
。 eosjS@16.0.9 


npm instal]l eosjsQ@16.0.9 


集成 步骤 
引用 组 件 包 


const eossdk = requlire( 'eosjs ' )， 


实例 化 


const eoSs = eossdk(({ 
chainId: "cfo057bbfb72640471fd910bcb67639c22df9f924 
ELEoLEDRG IaXe)SEDJIEER LEIE|0 且 区 区 7 全 6 辣 ( 且 人 区 呈 7 人 7 于 
keyProvider: "< 签名 交易 时 才 需 要 > ' ， 
Verbose: true， 
authorIzation: " '， 
expireInSeconds: 60， 
broadcast: true， 
Sign: true 


则 


触发 合约 方法 


const data = { 
[ 


actions : 
aceouniiie 本 过半 勾 多 过: 
manmen 各 约 阁 \ 寺 双 屋 
authorization: [{ 
actor:; < 用 户 名 >， 
permission: ' active， 
本 
data: 蔷 
< 参数 名 > : < 人 参数 值 > 
} // 合 约 方法 参数 。j son 或 数组 格式 
j 
] 
】} 
eos transaction(data) 
查询 合约 数据 


eos ,getTab1leRows({ 
json: true， 
code: "hackdappexch'"， 
scope: "hackdappexch'”"， 
tabJlje: "orderstruct ' ， 
key_type: "164 '， 
index_position: 1 
Taste ESO 
}+) .then((resuJlt )=>1{ 
Logger ,infol(resuJlt ) 
}).catch((err)=>{ 
Logger .error(err) 


]}) 


编写 示例 


帐户 间 转 帐 。 比 如 : eosio.testal 帐 户 向 智能 合约 hackdappexch 
转帐 100 EOS. 


配置 EOS 实 例 权 限 


chaln: 


chainId: "cfo57bbfb72640471fd910bcb67639c22df9f5 
风 攻 相国 医 m 和 OO ED 全 | 攻 7 有 O 本 日 本 和 信人 
keyProvider: "5K2jun7wohStgiCDSDYJjk3eteRH1KaxUQs 
verbose: true 

authorization: 'eoSsSio,testaQ@active 
expIireInSeconds: 10 

broadcast : true 

Sign: true 


转帐 操作 


Const 


data = 
[ 


act1lions : 


{ 
account : '"eoslio.token ' ， 
name: "transfer '， 
authorization: [{ 
actor: 'eoSlio.testa '， 
permission: "active” 
] 辣 怕 
data: 革 
from: "eoslo.testa '， 
to: "hackdappexch ' ， 
quantity: '10 EOS '， 


memo : 


} /7 合约 方法 参数 。json 或 数组 格式 


] 


eos transaction(data) 


提交 转帐 操作 后 ， 后 人 台 显 示 信 息 : 


2019-03-25 19:38:25 [dexchange#index,js] info: Submit 


查询 数据 


await eos,getTabeRows ({ 


json: true， 

code: "eoSslio.token'"， 
scope: "hackdappexch'”"， 
table: " accounts ' ， 
Key_type: "164 
Index_position: 1 工 ， 
imit: 30 


}) .then((resuJlt )=>1{ 

1ogger ,info( "After the transfer .XNn 
+) .catch((err)=>{ 

Logger .error(err ) 


效果 演示 


转帐 前 ， 查 询 帐 户 hackdappexch 余 额 


hackdappexch 


2019-03-25 19:38:25 [dexchange#index.js] Info: Before 
hackdappexch baJlance: 1{ 


JS 


则 
} 


[ 


"balance": "10.4000 E0S "” 


起 


"more":， false 


提交 转帐 操作 


2019-03-25 19:38:25 [dexchange#index,js] info: Submit 


转帐 后 ， 查 询 余 祷 


2019-03-25 19:38:26 [dexchange#index,js] info: After { 
hackdappexch baJlance: 1{ 
ONWSac 
"balance": ”20.4000 E0OS” 
] ， 


"more"， false 


到 此 ， 通 过 我 们 的 学 习 思 考 及 动手 实践 ， 杀 目 完成 了 对 Node 项 目 
实战 环境 过 程 所 必须 要 的 组 件 整合 过 程 。 


